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FCC NOTICE 


This equipment generates and uses radio 
frequency energy and if not installed and used 
properly, that is, in strict accordance with the 
manufacturer's — "instructions, ^ may cause 
interference to radio and television reception. It 
has been type tested and found to comply with 
the limits for a Class B computing device in 
accordance with the specifications in Subpart J 
of Part 15 of FCC Rules, which are designed to 
Provide reasonable protection against such 
interference in a ' residential installation. 
However, there is no guarantee that interference 
will not occur in a particular installation. — If 
ihis equipment does cause interference to radio 
or television reception, which can be determined 
by turning the equipment off and on, the user 
is encouraged to iry to correct the interference 
by one or more of the following measures: 


Reorient the receiving antenna. 
Relocate the computer with respect to the 
receiver, 

Move the computer away from the receiver. 
Plug the computer into a different outlet so 
that computer and receiver are on different 
branch circuits. 


If necessary, the user should consult the dealer 
or an experienced radio/television technician for 
additional suggestions. The user may find the 
following booklet prepared by the Federal 
Communications Commission helpful: 


"How to Identify and Resolve Radio-TV Inter- 
ference Problems." 


This booklet is available from the U.S. 
Government Printing Office, Washington, D.C. 
20402. Stock No. 001-000-00345-3. 


IMPORTANT SAFETY INSTRUCTIONS 


READ ALL INSTRUCTIONS 


TOPO is an electrically operated device. As 
with any such device, precautions should be 
taken while handling and using the product to 
avoid electrical shock. Service TOPO only when 
ihe robot is disconnected from the battery 
charger. 


BATTERY INFORMATION 


TOPO's batteries contain corrosive fluids and 
should be handled with care. As in all 
Fechargeable batteries, explosive gases could be 
vented during charging or discharging, so use 
TOPO only in a well ventilated area and keep the 
robot away from any source of ignition. 


Batteries should be recharged only by adults, 
and only with the battery charger supplied with 
the robot. Avoid any direct connection of the 
battery terminals thet will cause the batteries to 
short out. Do not make direct contact between 
the positive and negative terminals, as this could 
cause high current to flow, creating heat and 
the possibility of fire. 


Never charge the batteries in an upside-down 
position, and always keep them out of reach of 
children. 


Observe these simple precautions and you should 
enjoy many months of service from TOPO's 
batteries. 


SAVE THESE INSTRUCTIONS 
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in 1950, science fiction author Isaac Asimov 
published a collection of earlier stories in a 
book called "I, Robot." In the introduction of 
this book, Asimov stated that the major 
manufacturer of robots would come into 
existence in 1982. 


He was right about the date, but not about 
the company's name, Our name is Androbot 
Inc., and like Asimov's U.S. Robot and 
Mechanical Men, Inc., we came into existence 
in 1982. There ‘is, however, a major 
difference between the two companies - we are 
real, and so are our products. Robots are no 
longer just science fiction. 


So allow us to welcome you to a new era - the 
Age of Androbot 


Although we have made every attempt to verify 
the accuracy of this document and accompanying 
software, we cannot assume any liability for 
errors or omissions. No warranty or other 
guarentee can be given es lo the accuracy or 
Suitability of this software for a particular 
purpose, nor can we be liable for any loss or 
damage arising from the use of this software. 


Copyright Androbot Ine., 1983. All rights 
reserved. No part of this publication or accom- 
panying software packages may be reproduced in 
whole or in part except for the making of 
backup copies of the softwore for the sole use of 
the purchaser. Unauthorized copying or 
transmitting of this copyrighted software in or 
on any medium is strictly prohibited. 


Androbot products may be ihe subject of 
applications for Letters and Desicn patents. 
Infringement of the rights granted under these 
patents is expressly prohibited 


NOTE: Androbot inc. copyrights extend to the 
appearance of TOPO. All rights reserved 
including display rights. TOPO may not be 
publicly displayed without the prior written 
Permission of Androbot Inc. or one of its 
agents. 


TOPO and TopoSoft are registered trademarks of 
Androbot inc, 


Apple. Apple il+ and Apple lle are registered 
trademarks of Apple Computer, Inc. 


ECHO and ECHO II are registered trademarks of 
Street Electronics Corporation, 


SIGNATURE EDITION TOPO 


Congratulations, You are the owner of a 
Signature Edition TOPO, one of the first 500 
produced by Androbot, Inc. lt bears an 
engraved plaque signed by TOPO's inventor, 
Nolan Bushnell. 


In addition to all of TOPO's standard features 
and capabilities, your Signature Edition modei 
is equipped with two storage compartments 
(one on each side, beneath the shoulder area], 
and footlights near the Andromotion wheels. 


Opening TOPO's storage compartments is a 
snoep. With your hands in the position shown 
below. gently press down with your thumbs 
until ‘the latch opens and the panel swings 
down. Repeat the same hand motion when you 
are ready to close the latcn. 


OPENING TOPO'S STORAGE COMPARTMENTS 


The feotlights on your Signature Edition 
TOPO, shown below, blink to indicate the 
direction of rotation for each wheel. Whon 
TOPO is stopped or is moving forward, the 
footlights in front of each wheel will be 
blinking, When TOPO is moving backward, 
the foctlights in back of each wheel will be 
blinking. 


TOPO FOOTLIGHTS, 


These footlights indicate only the direction of 
wheel rotation and, along with the storage 
compartments, are found only on the Signature 
Edition TOPO. 


Your TOPO is numbered and will be registered 
in your namo, commemorating your leadership 
In the Age of Androbotics. 


INTRODUCTION 


"Robots are not people. Mechanically they 
are more perfect than we ore, 
- Karel Capek, R.U.R. 


INTRODUCING TOPO 


You have purchased a product that was pure 
science fiction a few short years ago - a per- 

sonal robot, As you learn more about your 
new robot (we have named it TOPO, after 
topography or topology), you will come to 

i Teslize that vou Ar » pioneer in a tatally new 

! and exciting field. Whether your applications 

i are practical, educational or just for 

| entertainment, you will soon be making TOPO 

i do things that mo one has ever made it do 

; before. 

i 

| 


Regardless of your applications for TOPO, we 

know omo thing - you will enjoy using TOPO. 
i TOPO will soon become a fomily member as it 

cruises around the house, obeying your com- 
mands to navigate, talk or play games. Your 
enjoyment end appreciation will grow as each 
sofware or hardware accessory and utility 
package Is added. 


its way. and that you do not want to read this 
entire manual first. In order to make this 
process zs easy es possible, this manual is 
: divided into sections guiding ycu from the 
most simple TOPO operations through the 
intermediate leve! to the most advanced uses. 
Detailed instructions are included for the 


i 


computer buff, or fer anyone who wishes to 
explore TOPO's full potential. 


TOPO can "welk" in any direction on a level 
surface, and can be made to "talk" in English 
and in various other languages. 


TOPO's movements can be simple, from point- 
to-point, or complex and refined. You will 
learn to make TOPO perform ever more complex 
movements and to talk with an almost limitless 
vocabulery of words and phrases. 


Once TOPO is unpacked and operational, a 
preprogrammed demonstration routine will make 
your robot perform a variety of basic activities 
to ensure that it is functioning properly. 
TOPO wil introduce itself to you, its new 
master. Then, we strongly urge you to read 
this entire manual. Each section contes 
valuable information, 


TOPO GENERAL DESCRIPTION 


TOPO is a computer-contrellad personal robot 
that can be programmed te "walk" over any 
path on a level surface, 


TOPO can be directed to speak with its pro- 
grammable voice, In addition to its basic 
speech, TOPO's voice can be finely tuned and 
shaped to sound more natural, TOPO can 
even be made io sing by controlling the pitch 
of its voice. 


TOPO enjoys a drive system that provides 
stability and safety without compromising ma- 
neuverability and control. This patented drive 
system is called "Andromoton." |t gives 
TOPO a unique personal gait and the ability to 


remain upright at all times. 


TopoSoft, a FORTH-based program developed 
by Androbot inc., offers simple, easy pro- 
grammability for TOPO. 


Messages and commands are sent to TOPO 
through a remote-control, infrared transceiver 
called the "base communicator, " 


Complete electrical, mechanical and environ- 
mental specifications for TOPO and its base 
communicator are provided in the Appendix 
section of this manual. 


WHAT DO | NEED TO USE TOPO? 


Your TOPO robot needs a computer to send it 
instructions. The version you have purchased 
is designed te be used with an Apple 1+ or 
Me computer. 


* To use TOPO, you should have an Apple 
llt or lie computer system with at least 
ABK of RAM. 


To use the enclosed TopoSoft diskette, 
you wil! necd a disk drive (16 sector). 


The Apple computer must have a Super 
Serial Card (an RS-232C serial port) for 
connecting the base communicator. 


For manual control of TOPO, you must 
also have an analog joystick connected to 
your computer. 


igure 1 shows the interconnections and re- 
lationship of TOPO to the battery charger, 
base communicator, computer and joystick, 


Computer 


COMMUNICATOR 
POWER SUPPLY 


= Joystick 


BATTERY CHARGER 


FIGURE 1 


TOPO/COMPUTER CONFIGURATION 


Figure 2 shows TOPO from front and back 
views, 


MAC HEADS TCH 


FIGURE 2 
TOPO 


The TOPO commancs you will iearn in this 
manual are based on the Mountain View Press 
(MVP) version of the FORTH computer lan- 
guage. As you leern the various movement 
and speech commands, you are really using the 
basics of FORTH, 


Although cven a newcomer to computers can 
quickly learn to control TOPO with the simple 
commands in this manual, even more interest 
and enjoyment will be yours if you acquire a 
more thorough knowledge of FORTH. 


We recommend these books: 


* STARTING FORTH 
by LEO BRODIE 
PRENTICE-HALL, INC. 
318.00 (soft cover) 
sescslf you wish to buy only one book, 
this is the one - an excellent tutorial 


for programmers cond non-program- 
mers olke. Appendix F of this 
monuot iists necessary corrections to 
STARTING FORTH. 


ALL ABOUT FORTH 

by GLEN B. HAYDON 

MOUNTAIN VIEW PRESS, INC. 

$25.00. {soft cover) 

^... The recommended reference work for 
the FORTH programmer. 


MVP-FORTH SOURCE LISTINGS. 

by G. HAYDON and R. KUNTZE 

MOUNTAIN VIEW PRESS, INC, 

320.60 (soft cover) 

sees Actual source code for MYP FORTH 
fwritten for the Apple il and IEM 
persona computers, and 9090-based 
CP/M systems? 


These books should be available at your local 
bookstore or computer dealer, or write to 


MOUNTAIN VIEW PRESS, INC. 
P.O, BOX 4656 

MTN. VIEW, CA sunuo 

(415) 961-4103 


There is one lest comment to be made before 
you unpack TOPO: TOPO IS NOT A TOY. 
TOPO is a full-fledged robot. 


TOPO uses only industrial grade components 
throughout, from high quality rechargeable 
batteries and 2 professional infrared trans- 
ceiver, to sturdy motors and cast aluminum 
gearboxes, a fabricated steel framework and a 
high-impact body. With proper care, TOPO 
will provide years of trouble-free service. 
And that matters to us, because providing 
service to humans Is what robots are ell about. 
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INSTALLATION 


“Help me to get moving, young lady, and PIE 
do anything you ask,” 
-The Tin Woodsman to Dorothy 
The Wizard of Or 
91535, Metro-Coldwyn-Mayer 


UNPACKING TOPO 


Your TOPO robot system comes packed in one 
box. As ybu unpack this box you will find: 


this manual and owner registration 
cards, 


a diskette containing the TapoSeft pro- 
gram linserted in a plastic sleeve in the 
back of this manual), 


TOPO's battery charger (the larger of 
the two black boxes with a bullt-in wall 
plug and power cord attached), 


TOPO's base communicator (the hexa- 
gonal device with three red sides in the 
Front), 


the communicator power supply (the 
smaller black box with a built-in wall 
plug and power cord attached}, 


the communicator cable (with a 9-pin 
connector on one end and s 25-pin, 
RS-232C connector on the opposite end. 


and one TOPO robot. 


Packed in the foam insert are all the items 
listed above, except TOPO, Remove and set 
aside the base communicator, battery charger 
and cables, then remove the large foam 
inseri, Underneath, you will find TOPO. 


In Efting TOPO from the box, DO NOT LIFT 
TOPO HY THE HÉAD. Reach down around 
both sides of TOPO at the shoulder area, as 
shown in Figure 3. Midway down TOPO's 
body are flat arezs suitable for hooking your 
hands. Gentiy lift TOPO from the carton and 
gently set it on tha floor in an upright 
position. 


CAUTION 


NEVER LIFT TOPO BY THE HEAD, AND 
NEVER DROP TOPO. EVEN THOUGH 
TOPO CAN TAKE A LOT OF ROUGH AND 
TUMBLE ACTION, THE ROBOT 1S A 
SOPHISTICATED “ELECTRONIC DEVICE 
THAT CAN BE DAMAGED IF DROPPED. 


Once TOPO is out of the shipping carton, 
continue to lift it from underneath the shoul- 
der area with both hands, as shown in Figure 
3. TOPO can also be lifled from underneath 
its base. 


if you look near the bottom of TOPO, you can 
see that it moves on two large wheels posi 
tioned at an angle to each other. This is the 
proper orientation for these wheels. TOPO 
balances in an upright position of its own 
accord, and if you give it a slight push, you 
will see that TOPO rocks back and forth a 
little bit without tipping over. This rocking 
mation is normal, and helps Keep TOPO from 
damaging itself or anything it might rum into 
by accident. 


The batieries can be completely recharged 
overnight. Once charged, they will provide 
hours of use before needing recharging. 
When TOPO is not being recharged, BE SURE 
TO DISCONNECT THE BATTERY CHARGER 
FROM THE WALL OUTLET, 


To turn TOPO on, press the green power-on 
button located on TOPO's back control panel, 
When you press the power-on button, the 
power-on light and the battery status light 
will iluminate. If TOPO is operating, the 
battery status light should be green, Indicat- 
ing that the batteries are charged, When the 
battery status light is red, it is time to 
recharge TOPO, 


TOPO has specie! battery protection circuitry, 
The overcharge protection circuit allows 2 full 
charge to be maintained by leaving the charg- 
er connected, with no possibility of damage, 
If you continue to operate TOPO after the 
battery status light turns red, the protection 
circuit will engage automatically and turn 
TOPO off. If this happens, simply charge 
TOPO overnight. 


While TOPO's batteries are being charged 
overnight for the first time, you should fill 
out and mail the enclosed registration card, 
This will place your name and address on our 
list of owners so we can inform you of future 
engineering updates (in return, vou will 
receive a free, ono year subscription to the 
"Androbot Report" newsletter, foaturing a 
regular exchange of Information and new 
applications for TOPO, as well as articles of 
interest by experts in the field of robotics). 
We also suggest that you use this time to 
read the rest of this manual and to connect 
the base communicator to your computer. 


the left, and stop, simply by pressing the 
appropriate corner of the headswitch, as 
described below. 


Te make TOPO move forward, 
press the front corner of the 
headswitch, marked: 


To make TOPO stop moving, 
press the back corner of the 
headswitch, marked: 


To make TOPO turn to the right 
in place (while stopped), press 
the right corner of the 
headswitch, marked: 


To make TOPO turn to the left 
in place (while stopped), press 
the deft corner of the 
hoadswitch, marked: 


You can also have TOPO make curving turns 
to the right or left by pressing 

right or left corner of the headswitch while 
TOPO is moving forward. 


Prectice making TOPO move by pressing the 
heedswitch. This will give you a feel for 
TOPO's movement characteristics. In Sections 
3 and 4 of this manual, you will learn how to 
use a joystick or type simple commands on 
your computer keyboard to make TOPO per- 
form its full range of movements. 


CONFIGURING THE SERIAL CARD 


In order io connect the base communicator, 


you should have an RS-233C Super Seriai 
Card, instslled |n slot 82 of your Apple 
Computer in accordance with directions sup- 
plied with the card (Appendix A provices 
instructions for configuration if you wish to 
use another slot for the serio! card]. 


The switches on the card must be set to the 
proper configuration in order for the compu- 
ter to communicate with the base communica 
dor. 


The switches should be set as follows: 


SWITCH | SWITCH 2 JUMPER 


00:111 ^ — prnionp * Block triangle: 
TET pointing up (A) 
toward "MODEM" 


This configuration is: Communications mode, 
9600 baud, 8 data bits, 1 stop bit, no parity, 
mo automatic linefeeds, no interrupts. 


INSTALLING THE BASE COMMUNICATOR, 


The base communicator is the device that 
sends and receives instructions between TOPO 
and your computer. |t is housed in n hexa- 
gonal plastic case with three red sides in the 
front and two jacks located on the back of 
the unit, The base communicator is shown in 
Figure 6. 


LOCATING THE BASE COMMUNICATOR 


You should place the base communicator at 
least three feet away from your computer or 
any other electrica! device te avoid electrical 
interference, Place the base communicator at 
tabletop height or higher, WITH THE THREE 
RED SIDES FACING THE ROOM, 


The signals emitted from the base communica- 
tor will bounce off walls and other surfaces 
and should reach TOPO even if there are 
ebstructions in the room, But, to get maxi- 
mum range from TOPO, be sure that the base 
communicator is placed in an unobstructed 
‘oration, with the three red sides in ə 
Sine-ef-Sight wit TOPO, TOPO will stop 
whenever it moves out of range of the base 
communicator. 


The bese communicator will require no main- 
tenance or attention on your part, other than 
placing it in a good location. 


Now that you have connected the base com- 
municator to your computer and have charged 
TOPO's batteries, you are ready to get TOPO 
moving and talking by remote control. 


IMPORTANT 


FOR COMPATABILITY WITH THE 
APPLE il+ COMPUTER. TOPOSOFT 
USES ONLY UPPER-CASE CHARAC- 
TERS. IF YOU OWN AN APPLE Ile 
COMPUTER, BE SURE THAT YOUR 
CAPS LOCK KEY IS DEPRESSED 
WHEN USING THE TOPOSOFT PRO- 
GRAM. 


COPYING THE TOPOSOFT DISKETTE 


All the computer Instructions necessary to 
make TOPO obey your commands are contzined 
on the TopoSoft diskette, packed in the clear 
Plastic sleeve in the back of this manual 


The TopoSoft diskette includes instructions 
for your computer on how to follow your 
commands [these instructions are called. in 
programmers! terms, the "boot" image), and a 
copy of the source code used in writing those 
instructions. 


The source code, which is discussed in 
Section 5, is included only as a reference for 
Programmers. 


Before going on, we strongly recommend that 
you make a copy of the boot image on a new, 
blank diskette. Use this copy whenever you 
operate TOPO, and save the original TcpoSoft 
diskette in a safe place to avoid loss or 
damage. 


To copy the boot image from the TopoSoft 
diskette, you must first “initialize? the blank 
diskette. 


To da this, remove the TopoSoft diskette from 
its protective plastic sleeve and insert it in 
disk drive #1 (with the label facing upward 
and toward the front of the disk drive), and 
close the disk drive door. 


Turn on your computer and wait several 
Second for the system to load the information 
from your diskette. You will see the message 


WELCOME TO TOPOSOFT V1.0 (C) ANDROBOT 


You may also see an error message, such es 


‘TOPO NOT HESPORDLNG 


If your system Is not completely set uj 

TOPO is not turned on. Even if thi 

pens, you should still continue creating your 
new boot image diskette. 

Remove the TopoSoft diskette and insert the 
blank diskette into disk drive #1, Then type 
the following command 


INIT-DISK 
Press the RETURN key on the keyboard and 
the following message wili appear on the 
monitor: 

BLANC DISK IR DR 1 (Y/R)? 
When the message appears, type 

Y 
and the message 

ERASIMC 


will appear on the monitor, followed, in a few 
seconds, by the message 


FORMATTING 
After a few more seconds, the message 
= 


will appear on the monitor, and the disk will 
be ready for copying. 


To transfer the boot image onto the initialized 
Giskette, typo the commend 


SAYE-FOÀTR 

Press the RETURN key, and 
OPERATING SYSTEM DISK TR DRY (T/N)? 

will appear on the display, 

Type 

Li 


and the boot image will be copied onto the 
new diskette, 


Once this is done, you should use the backup 
copy whenever you want to use TOPO. 


POWER-ON ERROR CHECKING 


When you first boot TopoSoft, it performs a 
Compete check to ensure that the communica 
tion system is working properly. For t 
reason. you should turn on TOPO and plug in 
ihe base communicator before you boot Topo- 
Soft. 


If any error messages appear on the display, 
correct the problem and then press the 
RESET key on your computer. (On some 
Apple computers, the CONTROL key must be 
pressed and held down before pressing the 
RESET key. From this point on, we will just 
tell you to press the RESET key) 


See the TROUBLESHOOTING chart in the 
APPENDIX section of this manual for a list of 
Common error messages and how to resolve 
them, 


After you RESET or boot the computer and no 
error messages appear, you are ready to use 
TOPO. 


MESSAGE FROM TOPO 
Get ready, because the fun is about to begin. 


Section 3 will explain the most basic commands 
you can give TOPO. Intermediate and ad- 
Vanced level commands are explained in later 
sections. But first, we would like you to get 
better acquainted with TOPO. 


TOPO has a few things to show and tell. So, 
for a surprise, clear an area at least five feet 
im ell directions around TOPO anc type the 
following command on your computer key- 
board: 


Then, press the RETURN key. 


And we, too, would like to welcome you to 
the world of Androbotics, and to wish you 
well in your furthur adventures with TOPO, 
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GETTING STARTED 


A robot may not injure o humon being, 

or, through inaction, allow a human 
being to come to horm 

2. A robot must obey the orders given it 
by human beings except where such 
orders would conflict with the First Law. 

3. A robot must protect its own existence 
ws long as such projection does not 
conflie? with the First or Second Low, 


= The three immutable laws of robots 


from "i, Robci* 
by Isaac Asimov 


ABOUT THIS MANUAL 


In this section, you learn how to make 
TOPO obey the simplest movement and 
speech commands. Other sections provide 
instructions for intermediate level operations. 
For the programmer cr more experienced 
owner, instructions are given for the most 
sophisticated kinds of activities. 


Even the novice will soon be adept at making 
TOPO perform complex activities by using 
simple, logical commands. 


For every command, an example is shown 
with the characters, symbols anc spaces in 
the EXACT FORMAT you should follow when 
typing the commands on your computer 
keyboard. 
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One symbol used frequently in this manual 
tells you when to press the RETURN key on 
your computer keyboard, This symbol is: 


BH This is the symbol we use for the 
RETURN key on your computer key- 
board. Any command you give TOPO is 
activated only when you press the [R] 
key, 


An example of a typical command sequence 
(these commands will direct TOPO to turn 
left 90 degrees and say "Hello') is shown 
below: 


90 LEPT BAY" HELLO" jE) 


IMPORTANT 


TO MAKE TOPO OBEY ALL COM- 
MANDS, BE SURE TO ENTER AT 
LEAST ONE SPACE WHEREVER 
SHOWN, AND DO NOT INSERT ANY 
SPACE ‘IN THE MIDDLE OF A WORD. 
ALSO, REMEMBER TO TYPE ALL 
TOPO COMMANDS USING THE UPPER- 
CASE ALPHABET ON YOUR COMPU- 
TER KEYBOARD, EXACTLY AS 
SHOWN IN OUR EXAMPLES. 


If you ever misspell a command word, the 
monitor will underline the misspelled word 
and display the following error message: 


OT RECOGNIZKD 
Remember these simple rules and you will 


have no trouble making TOPO do your 
bidding. 
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JOYSTICK CONTROL 


In a few moments, you will begin to learn 
how io make TOPO respond io commands 
entered on your computer keyboard. But 
TOPO can also respond io basic movement 
commands from an analog Joystick. 


Several widely available joysticks will work, 
so read the instructions provided with your 
joystick for directions on how to connect it 
to your computer. 


To activata joystick control, type 


sovsrtex (8] 


Now, you are ready to control TOPO with 
the joystick, 


If TOPO moves slightly, even when the 
joystick is centered, adjust the trim lovers 
on the Joystick case (these levers are located 
on the top, bottom or sido of the Joystick 
case, depending on the brand and model) 
until TOPO stands absolutely still when the 
Joystick is centered. 


Orient the joystick in your hands so that 
pushing the Joystick forward will make TOPO 
move forward. Then, move the joystick in 
several directions anc practice guiding TOPO 
for a few minutes to get a feel for the speed 
of TOPO's responses. 


Te return control of TOPO te the computer 
keyboard, press either button on the 
joystick, or any key on the keyboard (the 
Space bar or IR) key are recommended), 


SIMPLE MOVEMENT COMMANDS. 


TOPO can be ordered to move forward and 
backward, and to turn right and left. 
Forward and backward movements are 
measured in centimeters (1 inch equals about 
2.5 centimeters}. Right and left turns are 
measured in degrees. 


For example, to make TOPO move forward 
200 centimeters (6 1/2 feet}, just type the 
following command 


200 rio [i] 


To stop TOPO while it is moving. press the 
RESET key on your computer keyboard [we 
call this the "panic stop" RESET), or press 
the reer corner of TOPO's headswiich. 


To make TOPO move backward 100 
centimeters, type 


108 sace [s] 


TOPO will make a 30 degree right turn with 
the command 


LE T] 


And TOPO will meke a 135 degree left turn 
with the command 


195 art E 


IMPORTANT. 


YOU CAN TYPE A MAXIMUM OF 80 
CHARACTERS AT A TIME, SO BE SURE 
THAT YOUR COMMAND SEQUENCE IS 
NOT MORE THAN 79 CHARACTERS IN 
LENGTH - INCLUDING SPACES - BE- 
FORE PRESSING THE [R] KEY, 
OTHERWISE, THE COMMAND WILL 
ACTIVATE ^ AUTOMATICALLY WHEN 
YOU TYPE THE 80TH CHARACTER ON 
THAT LINE. 


Later, you will learn how to make TOPO 

perform more sophisticated movements, and 

how to order TOPO to perform a number of 
i sequence, often requi 

than a single line of commands. 


MAKING TOPO TALK 


You can direct TOPO to speak in English 
and in various other languages with its 
text-to-speech voice feature.  TOPO's voice 
can also be made to sound quite natural - 
even to sing - by controlling pitch, volume 
and speaking rate, 


Section 5 of this manual provides detailed in- 
structions for getting the most cut of 
TOPU's speech module. — The following 
peragraphs will get you started by 
explaining two of the most basic speech 
commands you can cive TOPO, 


To make TOPO talk, type the command 
SAY" followed by a space, then type the 


words you want TOPO to say, followed by a 
closing quotation mark, Be sure to put a 
space between every word, Press the [R] 
key and TOPO will start to talk. 


For example, to make TOPO say "Hello. My 
meme is TOPO," just type the following 
command: 


SAY" EELLO. WY RAME IS TOPO" T) 


Try it, and then practice making TOPO say 
more words and phrases. 


You will notice that TOPO's voice has some 
intonation, but still sounds somewhat 
mechanical, Section 5 will tell you the many 
ways you can refine end tailor TOPO's voice 
to sound more natural, One of these 
refinements can be achieved by changing the 
pitch of TOPO's voice. 


TOPO's voice can be varied to sound lower- 
pitched or higher-pitched over a range of 63 
Steps, from | to 63, A setting of | Is the 
lowest pitch, and a setting of 63 is the 
highest pitch [each increase or decrease of 
70 steps wii cause TOPO's voice to change 
by about one octave). 


TOPO's pitch was set at the factory at 74 
(this "normal" setting of 24 is called the 
“default value"), but you can change tha 

h by using a simple SET-PLTCH 
command. To change the pitch of TOPO's 
voice, type the number of the desired pitch 
(any number from 1 to 63) followed by a 
Space and the command SET-PITCH. All 
SAY" phrases will now be spoken at the new 
pitch until you set the pitch again or turn 
eff TOPO 


E 


For example, to make TOPO say, "Hello, My 
name is TOPO" in a lower voice than you 
heard in the last example, type the command 


3 SEE-PITCR SAY" MELLO. MY NAME I$ TOPO" [R] 
Try it, end listen to TOPO's lower voice. 


To make TOPO say the same sentence In a 
higher voice, type the same command with a 
high pitch number, as in this example: 


5D SET-PITCH SAY" BXLLO, MY MAKE 1S TOPO" [E 


To make TOPO's voice return to its original 
pitch. type the SET-PITCH command again, 
using a pitch value of 24, as shown below: 


25 SET-PITOH [È] 


Controlling pitch is only one of the ways you 
can make TOPO's voice sound different. 
Section 5 will show you how to explore the 
sophisticated features of TOPO's speech, 


USER-DEFINED COMMANDS 


TOPO can be programmed easily to perform a 
variety of activities in sequence using only a 
Single, user-defined word or character. 
This feature of the TopoSoft program (and 
the FORTH programming language) is called 
creating a "colon definition." 


For exemple, making TOPO perform a 90 
degree right turn, say "Hello there," then 
turn left in a complete circle, require 
the following string of individus! commands: 


90 RIGHT SAY” FELLO THRER" 360 LEFT E] 


You can make TOPO perform these same 
threo activities with a singíe command, The 
name you choose for the command can be any 
character, symbol or combination of charac- 
ters {except the space bar) - up to M 
characters in length, 


For example, you may wish to neme this 
routine "GREET" and have TOPO perform the 
sequence of activities whenever you type the 
command GREET. To do this, type the 
following commands, being sure to start the 
command line with a colon and end the 
command with a space ond a semicolon before 
pressing 


: GREET 90 RIGHT SAY" HELLO THERE" 360 LEFT ;[R] 


Now, type the command 


a single 
command (instead of using & chain of indivi 
dual commands] is called creating a colon 
definition. The word GREET was used in 
this example, but remember, you can create 
a colon definition using any character, 
symbol or combination of characters up to 31 
characters in length. 


Some words may already be defined in 
TOPO's internal programs. Or. they may be 
distinct command words or words thet have 
been used creating other colon definitions. 
For instance, if you had created the colon 
definition shown im the last example, but had 
used the word "LEFT" (a TopoSoft command 
word), instead of "GREET," the computer 
monitor would clsplay the message 


LEFT 15WT UNIQUE Line | Lint} 


You could still use the new word "LEFT, 
but now you could no longer make TOPO do 
a simple left turn with the LEFT command, 
So be sure to use unique words for your 
colon definitions. 


To erase the duplicate word "LEFT" before 
exchanging it for another word, type the 
following command: 


woucet ine [E] 


Then, create your colon definition using > 
different word. 


Now, create some colon definitions of your 
own and see how easy it is. 


You can create » colon definition using more 
than one command line by typing (Rl when- 
ever “is. convenient (but never in ihe 
middle of a word). You will keep adding to 
Your colon definition until you type the 
terminating semicolon. 


At this point. any colon definitions you 
create will be lost when you turn off the 
computer, or if you perform a "panic stop" 
RESET. “in Section 4, you wil learn how to 
save your colon definitions on the TopoSoft 
diskette, 


You have now learned how to make TOPO 
perform basic movements and basic speech in 
response to commands from your computer 
keyboard. This Is like teaching & child how 
to take his first steps and say his first 
words. |n the following sections, you will 
learn bow to expand TOPO's ‘movement, 
speech and human interaction capabilities. 


MOVING ON 


"Dave, you know | am incapable of error.” 
- HAL 9000 Computer 

2001, A Space Odyssey 

©1968, Metro-Goldwyn-Moyer 


MORE ON MOVEMENT 


In Section 2, you learned simple movement 
commends ic produce basic forward and 
backward movement, and right and left 
turns. TOPO is also capable of refined 
movement, where you can control speed, 
acceleration and deceleration. perform smooth 
turns while TOPO is moving forward or 
backward, and make TOPO "park," while 
retaining any colon definitions you have 
created. 


CONTROLLING TOPO'S SPEED 


TOPO's Initial speed was set at the factory, 
but you can make tho robot move faster or 
slower by using the SET-SPEED command. 


TOPO is set at the factory to move at a 
reasonable speed, but you can vary the 
speed from ^ centimeter/second to about 50 
centimeters/second, depending on the charge 
level of the batteries. For example, to make 
TOPO move at a slower speed, type 


10 sEr-semep [E] 


ss 


and all subsequent motion commands will 
make TOPO move at the new speed. 


Try faster and slower speed movements 
using the SET-SPEED command 


ACCELERATION/DECELERATION RAMP 


TOPO does not begin or end a movement et 
top speed, but with gradual acceleration to 
speed and gradual deceleration at the end of 
a movement, This zcceteraüion/deceleration 
"ramp" is measured in centimeters per sec- 
end per second (cm/sec?). You can alter 
the ramp value over a range of 1 to 255, 


Te make TOPO reach top speed very quickly 
and slow down abruptly at We enc cf a 
move, type 

250 ser-num [E] 


To make TOPO reach top speed end slow 
down at a very gradual rate, type 


20 sar- [Ej 


or a similar command, 


To reset TOPO's ramp speed to the original 
setting, type the command 


RESET-MOTION [E] 


The RESET-MOTION command wili also stop 
TOPO, and will reset SET-SPEED and SET- 
RAMP values to thelr originai default 
settings. 
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CURVED PATH MOVEMENT 


In Section 3, you learned how to make 
TOPO perform right and ‘eft turns in ploce 
and straight-line motion. — You can also 
make TOPO perform curved path motion 
with the command ARC. 


ARC is made to work by telling TOPO the 
angle and distance of the curve, in degrees 
and centimeters. 


The ARC command requires an entry for 
BOTH angle and distance, For exemple, 
the command 


90 100 arc 'E) 


wili make TOPO perform a 90 degree right 
turn while moving forward over a distance 
of 100 contimeters. 


To make TOPO curve to the left, type a - 
(mimus) immediately before the degree 
entry. For example, the command 


-90 100 anc E] 


will make TOPO perform a 30 degree left 
turn while moving forwerd over a distance 
of 100 centimeters, 


If you type - (minus) in front of the di 

tance, TOPO will perform the curve whit 

moving backward. For example, the com- 
mand 


180 -100 anc [E] 


aT 


wil! make TOPO perform a 180 degree right 
turn while moving backwerd over a distance 
of 00 centimeters, 
The command 

-90 -100 anc [R] 
will make TOPO perform a 80 degree teft 
turn while moving backward over a distance 
of 100 centimeters. 
Try the command 

360 300 anc E) 


end watch TOPO turn to the right in a 
complete circie. 


Now, try tha command 


720-600 arc [E] 


In this example, you saw TOPO make two 
full backward circles, 


What happens if you specify an ARC 
command using "0" for one of the entries? 
For example, type these two commands end 
watch whet happens: 


© 100 ane E) 


90 0 anc [E] 


As you may have expected, in the first 
example, TOPO interprets an ARC command 
with 0 degrees as a simple FWD command 
because the command told TOPO to move 
forwaró 100 centimeters while turning 0 


E 


degrees, In the second example, TOPO 
interprets the ARC command with 0 distance 
the same as 2 simple 90 RIGHT command. 


In fect, the simple movement commands you 
learned in Section 3 (FWD, BACK, LEFT and 
RIGHT) are really all ARC commands in 
disguise. 


Now you are ready to practice the ARC 
command by making up some of your own, 
And, white you are at It, try linking some 
simple movement commands with ARC 
commands, and create some colon definitions 
inking alí the commands you have learned. 


INTERRUPTING A MOVEMENT COMMAND 


While performing a sequence of movement 
commands, you may wish to interrupt TOPO 
and ge on to another operation, As you 
learned earlier, the RESET-MOTION command 
will make TOPO stop meving, but it will also 
reset the SET-SPEED and SET-RAMP para- 
meters back to their defeult values. The 
"panic step* RESET work, but it also 
discards any colon definitions you may have 
created, 


To stop TOPO in the middie of a movement 
and retain all the parameters, type the 
command 


rans E) 


The PARK command will make TOPO stop 
immediately, and discard any remaining 
movement commands you have typed (while 


retaining your SET-SPEED and SET-RAMP 
values). 


INTRODUCING A DELAY WHILE MOVING 


You can direct TOPO to delay starting 2 new 
activity [such as speech} until it has fin- 
ished performing movement commands, 


For example, you may wish to have TOPO 
move forward, turn around and THEN begin 
talking. If you typed the “appropriate 
commands in sequence, TOPO would begin 
talking almost immediately after beginning its 
forward movement. 


To delay the speech until TOPO has finished 
ALL movement commands, type the command 
CIEL-STOPPED before the speech command, 
as in the following example: 


100 FWD 180 RIGHT TILL-STOPPKD SAY" HELLO" E] 


HEADSWITCH USES AND COMMANDS 


When you first tum en TOPO, pressing the 
headswitch will make TOPO move forward, 
perform right and left turns, and stop, as 
discussed in Section 2. In this state, the 
heedswiteh is in the HEADFOLLOW mode. 


Mf you are controlling TOPO from your com- 
puter Keyboard and wish to disable the 
HEADFOLLOW function, tvpe the command 


DISABLE-ERADPOLLOV [E] 


Now, TOPO will stop automatically whenever 
you" press any fheadswitch, To return 
TOPO to the HEADFOLLOW mode, type this 
command 


ENABLE-HEADFOLLOV [E] 


In Section 6, you will learn how to read the 
headswitch values in order to control a 
great variety of movement and/or speech 
activitios, 


PRECISION POSITION CONTROL 


In normal configuration. TOPO will attempt 
to blend one movement command with the 
next, This blending mode is called MOVE- 
SMOOTH and is the defeult setting for 
TOPO, The MOVE-SMOOTH mode, while 
reasonably accurate, may introduce small 
Positioning errors ‘that could accumulate 
over time. 


To assure more precise positional control, 
use the MOVE-EXACT mede, by typing the 
command 


wovs-ExACT [E] 


The MOVE-EXACT mode will cause TOPO to 
come fo a brief, full stop between all 
further movement commands. ensuring even 
more precise movement, 


Use the MOVE-SMCOTH command to return 
to smooth motion,  [RESET-MOTION will 
aise set mation to smooth). 


RESETTING MOVEMENT/SPEECH PARAMETERS 


An additional reset command will stop TOPO 
and reset all on-board parameters (SPEED. 
PITCH, HEADFOLLOW etc.) to their default 
values. To activate this command, type 


XESET-TOPO E] 


This command will cause TOPO to perform a 
complete power-on cycle 


SAVING COLON DEFINITIONS. 


When you turn eff your computer, or if you 
do a "panic stop” RESET, all the colon 
definitions you have created will be lost, and 
must be recreated if you wish to use them 
again. 


These colon definitions can be saved on your 
diskette if, before turning off your com- 
puter, yeu type the following command: 


save-ronte [E] 


Te execute the SAVE-FORTH command, you 
should have the boot disk In disk drive #1. 


SPEECH 


"f you do not speok English, | am ot your 
disposal with 137 other languages, ctong with 
their releted dialects à subtongues." 


- Robbie the Robot 
Forbidden Planet 
©1956, Loew's Incorporated 


ABOUT THIS SECTION 


TOPO nas a sophisticeted system called 
"text-to-snecch" which allows you to instruct 
TOPO te say exactly whet is typed on the 
computer keyboard. The "text" you type is 
converted into strings of phonetic characters 
by rules stored in TOPO's speech module. 
Other rules change these symbols into speech 
sounds that are also stored in the speech 
module. 


This section explains all the commends you 
can use to tell TOPO what to say and what 
kind of voice to use while talking. You will 
also learn how to make TOPO perform some 
advanced voice functions. 


To introduce you to the many ways you cam 
control TOPO's speech, here is a list of the 
commands we will discuss in this section, with 
a brief definition of each one: 


Speak (the following 
words), as if reading 


a 


SET-PITCH 


SET-VOLUME 


TALK-FAST 


TALK-SLOW 
TALK-LEVEL 


TALK-WAVY 


TILL-SILENT 


SAYS 


SAY-LATER* 


SAY-T. 


SAY-WORDS 


SAY-LETTERS 


Set the overall pitch 
level of TOPO's voice. 


Set the overall volume 
level of TOPO's voice. 


Speak faster than the. 
normal rate. 


Speak at a normal rate. 
Speak in a monotone. 


Speak with normal, 
Variable intonation’ 


Process no other com- 
mands until TOPO is 
finished talking. 


Speak the answer to an 
arithmetic problem. 


Do not speak (the fol- 
towing words) until 
ordered to speak, 


Speak all SAY-LATER" 
phrases. 


Put word boundaries at 
avery space or punctua~ 
ton, as in — normal 
speech. No effect in 
Phonetic mode. 


Pronounce each letter 
individually, No effect 
in phonetic mode, 


SAY-SOME-PUNC ^ Do rot pronounce ordin- 
ary punctustion, No ef- 
fect in phonetic mode. 


SAY-MOST-PUNC Pronounce ordinary 
punctuation. No effect 
in phonctic mode. 


SAY-ALL-PUNC Pronounce all punctua~ 
tion. spaces, etc, No 
effect in phonetic mode. 


RESET-SPEECH Reset the speech module 
ta power-on state end 
cancel any — currently 
executing speech, 


PHON"! Speak the following 
phonetic symbois. 


As we discuss each command. you will see an 
example of how that command is used, These 
examples are shown in the EXACT FORMAT 
you should follow when typing the command 
on your computer keyboard. Remember to 
type all characters lincluding punctuation and 
spaces] exactly as shown. 


Two new symbols are used in this section. 
One of the symbols is used to represent a 
String of words er characters, and the other 
is used to represent a numerical value. 


For example, the SAY" command is always 
followed by “a string of characters, repre- 
sented in this section by the symbol st 
The string shown after the SAY" comman 
below. Tépresents the character or wards you 
want TOPO to speak. 


sav” stzing” [k] 


As in previous examples, the (Rl is the 
RETURN key on the computer keyboard, 


In some other commands, you will have to 
specify a numerical value, such as for a pitch 
level. These numbers, which must be typed 
im front of the actuel commands, ere 
symbolized by n, es shown below: 


a serer E 


All commands that include a quotation mark 
(SAY", PHON" and SAY-LATER") must also 
have a closing quotation mark after the strin 
cf characters you want TOPO to speak, a5 TR 
this example 


SAY” string” [E] 


Remember that there must be a space after 
the commend SAY" but it does not matter 
whether there is a space before the closing 
quotation mark, 


TEXT-TO-SPEECH MODE 


TOPO wili speak any words you type after 
the SAY" command. For example, to make 
TOPO say "Hello. My name is TOPO" type 
the following command: 


SAY" MELLO. XT RANE TS TOPO" [i] 


TOPO begins to talk when you press [E] at 
the end oF the fine. 


Punctuation marks have an effect on TOPO's 
speech, With any text vou type using the 
SAY" command, the speech module knows that 


it should make TOPO's voice pitch go down 
before a period (or colon or exclamation 
point), and stey level before a semicolon or a 
Question mark, 


The speech module will also insert pauses 
after commas - more commas produce longer 
pauses. 


How much can you get TOPO to say at one 
time? Each SAY" command can ve followed by 
as many words as can be written on an 
80-charecter line. Or you can write as many 
lines of text as you like if you create a colon 
definition, discussed in Section 3, 


There is normally no limit on sentence length: 
TOPO can speak a single sylabie, or a 
sentence dozens of words long. However. 
TOPO can accept no more than about 1700 
characters at a time without getting into 
trouble. After that, some characlars may get 
Jost. 


CONTROLLING TOPO'S PITCH AND VOLUME 


You can affect the pitch and the loudness 
[volume] of everything TOPO says by using 
SET-PITCH and SET-VOLUME ^ commands. 
Both of these commands require an n value at 
the beginning of the command. ~ 


The SET-PITCH command changes the overall 
pitch of TOPO's speech, on a scale of n = 1 
io 63. The highest pitch is 63, the lowest is 
T, and the preset, or "default" value (TOPO's 
pitch when you turn on ihe power], is 24. 
Each increase or decrease of 20 steps will 
Cause TOPO's voice to change by about one 


octave. For example, the command 
1 srr-errn(] 


sets the pitch to about an octave lower than 
the command 


21 rr-errcv[g] 
You can make TOPO speak "n a softer or 
louder voice by using the SET-VOLUME 
command. TOPO's default volume is 12, on a 
Seale of n = 0 to 15, 


For exemple, to make TOPO speak in a very 
quiet voice, type 


5 seT-voLUMe [E] 


To return to the original volume, type 


12 $s-vormms [E] 


Every time TOPO is turned on. the preset 
default values are present. 


CONTROLLING TOPO'S SPEECH RATE 


TOPO's rate of spesking is preset at the 
factory te sound like natural, relaxed human 
speech. You can make TOPO talk at a faster 
rate by using tne command TALK-FAST. For 
exompie. to make TOPO say "How are you 
today?! at a fester rete then normal, type the 
following commands. 


TALE-FAST SAY" HOW ARE YOU TODAY?" [E] 


To return TOPO's speech to the normal rate, 


use the command TALK-SLOW as in this 
exampl 


TALK-SLOW SAT" BOW ARE YOU TODAY" 


Only these two speech rates are defined by 
commands. To make TOPO talk more slowly 
than normal, insert commas (pauses) between 
words and sentences, or try lengthening 
vowels, as discussed later in the subsection 
on special effects. 


CONTROLLING TOPO'S INTONATION 


Some intonation {pitch contour) is programmed 
into TOPO's voice at the factory. This 
Intonation is assigned to each senience by a 
set of rules in TOPO's hardware. 


These rules are based on en examination of 
typical speech patterns used in English, and 
cannot be modified by the user. They will 
cause foreign languages (discussed later in 
this section) to sound as though they are 
being spoken with a decidedly American 
accent. 


The intonation of  TOPO's speech can, 
however, be turned off with the TALK-LEVEL 
command, For example, to remove all 
intonation so that TOPO speaks in a 
monotone, type the following command: 


TALK-LEVEL SAY" SHOW FALLS IN MINTED [E] 


To return to the automatic intonation 
assignment, use the command TALK-WAVY as 
in the following example: 


TALE-MAYY SAY" SHOW FALIS IN WINTER“ [R] 


DELAYING COMMANDS DURING SPEECH 


Norma!y, TOPO will respond to consecutive 
speech commands and movement commands 
almost simultaneously. For instance, a 
lengthy speech string followed by a movement 
command will calise TOPO to begin moving 
while still speaking, You can make TOPO 
delay the movement command until finished 
with the speech by using the TILL-SILENT 
command, which orders TOPO to delay all 
further activities unti finished talking. 


For exampie, with the command 
SAY" HELLO THERE” 360 rxcmT [E] 
TOPO will begin turning while still talking. 


But, with the command 


SAY" HELLO TR" TILL-STLAWT 360 RIGHT [R] 


TOPO will finish talking before beginning the 
turn. 


PRONOUNCING NUMBERS 


TOPO can speak the answers to arithmetic 
Probleme solved by your computer if you use 
the SAY# command, For example, listen to 
what happens when you type this command: 


5 art E 


In fact, TOPO will speak any number 
resulting from any operation if you use the 
SAY# command, 


To hear the answer to the problem "10 minus 
3," try this command 


103 - sind 


(The above exemple of an arithmetic entry is 
correct. See STARTING FORTH for an 
explanation of mathematics in FORTH.) 


ACTIVATING STORED SPEECH COMMANDS 


You may want to write 2 string of words or 
sentences that TOPO will remember, but not 
speak until you give the command, This is 
especially useful If you have several SAY* 
commands in a row end do not want TOPO to 
do anything until you have finished typing all 
of them, This situation calls for a 
SAY-LATER" command, 


The character string following a SAY-LATER" 
command is sent to TOPO as soon as you 
finish typing the line, but TOPO is told not 
to speak at that point, A second 
SAY-LATER" following the first sends a 
second line that queues up behind the first 
line, anc will be spoken right after it as soon 
as you give the command to talk. 


To make TOPO speak the messages stored in 
all previously unspoken SAY-LATER" 
commands. type the following command: 


save] 


Note that any other speech command, except 
TILL-SILENT, TALKING, — SPEECH-FULL?, 
RESET-SPEECH, or another SAY-LATER' wiil 
also activate the stored speech. For 
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instance, if you do a SAY-LATER" and then a 
SET-PITCH, the stored speech will be 
activated. 


PRONOUNCING WORDS AND LETTERS 


TOPO's normal speech behavior is to speak 
words ihe way we normally do, This 
standard method of speaking corresponds to 
the command 


sAY-VORDS 1) 


But, in addition to speaking words, TOPO 
can spell them out if you type the command 


Sar-arTees [R] 


PRONOUNCING SYMBOLS AND PUNCTUATION 


TOPO will normally pronounce by name only 
the following special symbols: 


eFereterco f 
This means that the symbols 
"DOLI 


may be used as punctuation marks when you 
are typing sentences for TOPO io say, just 
2s they are used in normal human speech. 
However, . (period) is pronounced when it is 
followed immediately by another character and 
not by a space. 


For exemple, type the following command ond 
sten to the result: 


sav" 3.43" il) 


TOPO will oniy pronounce large numbers 
digit-by-cigit. You will have to write out 
phrases like "ane hundred sixteen dollars and 
thirty five cents" If you want them to sound 
right, rather than typing $116.35. 


TOPO's normal attitude toward punctuetion 
corresponds to 


s7-045-roNc [k] 
which is the default setting. 


In the SAY-SOME-PUNC setting, some of the 
punctuation will be spelled out, but not the 
Symbols we most commonly use as 
punctuation. 


The symbols listed above that are NOT 
pronounced in the SAY-SOME-PUNC setting 
(for example, commas) wil be pronounced if 
you type 


sax-xosr-eoxc [E] 


The command. 
SAY-ALL- POR (E) 


makes TOPO comment on the occurrence of 
spaces. linzfeeds and carriage returns as well 
— things you do not notice, but which occur 
naturally as you type on your computer 
keyboard, 


RESETTING SPEECH FUNCTIONS. 


The RESET-SPEECH command will reset 
TOPO's speech module by returning it to the 
default state it is in at power-on, This 
command will silence TOPO immediately, and 
all speech parameters that you moy have 
altered [SET-PITCH, SET-VOLUME, ete.) will 
be reset to their default values. 


BETTER SPEECH WITH SAY" 


TOPO's speech module is very good at saying 
whatever you type, but it's not perfect, To 
improve TOPO's ‘pronunciation in text-te~ 
speech mode, you can use your knowledge of 
written English to play tricks on the speech 
module. Far example, the name CHRIS will 
be pronounced as if it had a 'z on the end. 
f you spell it CHRISS (as in MISS}, the 's! 
will come through clearly. 


Table 5-1 is a collection of alternative spel- 
lings for various sounds. Some of the ex- 
amples indicate changes that must be made 
from the original spelling, and some do not. 
(Most of the time, of course, TOPO will 
pronounce words ‘correctly without your 
intervention.) 


The sound is represented by the underlineri 
portion of a word containing it. The general 
rule of thumb is: think of another word thal 
hes the same sound, but In which the sound 
is spelled differently, and try using that type 
ef spelling, You do not have to change the 
Spelling of an entire word - just the spelling 
of the part that is causing problems, Also, 
sometimes when there is è problem, you de 


not have to change the spelling at ail, Just 
put a space between syilabies, as in the final 
sot cf examples in the table. 


TABLE 5-1 


SPELLINGS FOR BETTER PRONUNCIATION 


SQUNDALTERNATIVE EXAMPLES. 


bee 


‘SPELLINGLS) 


EE cease 
achieve 


pretty 
ia women 


ache 
‘phase 


breath. 
nephew 
national 


none 
above 
aqua 
father 
lose 
Sruise 
avenue 
boulder 
ealon 


window 
scroll 
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CEESS 


PRITTY 
WIHMIN 


AYK 
FAZE 


BRETH 
NEK FEW 


NAE TIONAL 


NUN 
UHBUV 
OKWA 


FOTHER 


LOOSE 
BROOZE 
AVI NEW 


BOLDER 
COWLON 
WIN DOE 
SCROLE 


ARE or AIR 
ER or UR 
OUER 


(space) 


character 


search 
devour 
‘abel 
aqua 
question 
alpha 
gas 
mustache 
his 
advice 
arrive 
croate 
define 


depart 
finish 


goodbye 
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SWON 
CAWST 


FYNAL, 
EYELL 
SIGHCLE 
HITE 
BLYNED 
BROUN 
BUTEE 


SWAIR 
CARE ECTER 


SURCH 
DEVOUER 
LAYBLE 
OKWA 
KWESCHUN 
AL FA 
CASS 
MUSTASH 
HIZS 

AD VICE 
UH LIVE 
UH RIVE 
CRE ATE 
DE FINE 
DE PART 


FIN ISH 
COOD BYE 


TABLE 5-1 [continued] 


maybe MAY BE 
micro — MY CRO 
multiply MULTI PLY 
precise PRE CISE 
psychiatrist 

SY KY UHTRIST 
replacement 

RE PLACE MENT 

sideways 

SIDE WAYS 
taken TAKE N 
volume — VOL YOOM 


* pronounced as two syllables 


PHONETIC SPEECH MODE 


In addition to its text-to-speech capability, 
TOPO has a second, quite versatile phonetic 
speech moda, In this mode, you can specify 
the actual sounds to be strung together to 
create more precisely the words (in any 
language) TOPO will speak. 


Rather than typing the speech in standard 
spelling, you can use ihe phonetic (PHON") 
command with strings of special phonetic 
codes, The speech module that is TOPO's 
"voice box" handles either phonatic cr ordin- 
ary character strings In response to the two 
different commands: PHON" or SAY", 


For example, here is a command we saw in 
ihe discussion cf SAY", but using the PHON" 
command 


PHOR" HE LO MI WAM IZ TO PO" [E] 
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The special phonetic codes, which represent 
actual sounds more closely then standard 
spelling, ore shown in Table 5-2, But, 
before delving into them, you may wonder 
why we would want to use this method at all, 
since in tho above exompie, the result doesn't 
sound any better than the SAY" example, 
Why go to the trouble? 


One obvious answer is that this phonetic mode 
gives you a way of specifying the pitch and 
foudness of individual sounds and words quite 
precisely, which you cannot do with SAY" or 
any of the other commands presented so far, 


Not only can you got the PHON" example to 
sound like the SAY' example, with normal 
spelling, you can get it to sound much 
better. 


For an interesting demonstration, type the 
following commands: 


Troan” mo L 30,3 X 7! WEN 72 103 e 30” E) 


|PEON" X 78 L 20,3 M 7! N 48M GIZS T 90 P 20"[R] 


[ruow" —HTEL 20,3 K 4t HEM «49413 -z5 ,2 —T 20 P 20" 


In the first example, you reproduced the 
Intonation that is automatically assigned when 
you use SAY". In the second example, the 
intonation is improved, so that the two 
sentences sound more natural, |n the third 
exemple, o further change alters the meaning 
of the sentence, 


You will have noticed that sentences in the 
PHON" mode should not be typed with any 
punctuation in the usual sense, The charzc- 
ters that we would normally use as punc- 
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tuation marks now stand for different speech 
sounds, You must specify all pitch changes 
and pauses yourself, using numbers to indi- 
cate pitch levels and commas to show pauses. 
We will provide more details below. 


The period is used In a special wey in phone- 
iic mode. Try typing the following: 


PHON" LAST HOP.” [E] 


The speech module has a special characteristic 
that will make TOPO speak the same sentence 
pwice when it is followed by a period in 
phonetic mode: once with the pronunciation 
you expect from the phonetic codes that 
fellow the PHON" command, and the second 
time as if this were a SAY! command. Thus 
HOP is pronounced two different ways in the 
PHON" example, above, You can confirm 
what is happening by typing 


SAT" LAST HOPE. LASY nor.” [E] 


Except for the pitch, this will sound the same 
as the previous example with PHON?, 


This feature can be useful for experimenting 
with TOPO's speech rules, but normally you 
wili want to avoid its complications by remem- 
bering not to put a period at the end of a 
PHON" sentence, 


In Tabie 5-2, the speech sounds are divided 

o vowels and consonants, [The reason for 
dividing the consonants into two classes will 
become clear later.) 


The sound that each special symbol 
represents is explained by an example, the 
underlined portion of a short ward. Most of 
the symbols have the same value in both this 


phenetic mode and in regular spelling. But, 
as we saw cbovo with HOP vowels may have 
different values fer a given word. 


English spelling is notorious for having the 
same letters stand for different sounds [as in 
though, through, cough and rough}, and for 
havifig" one Sound “restesented Dy different 
letters (as in car, cop). The phonetic 
Symbols eliminate both kinds of ambiguity, 
beceuse a single symbol stands for a single 
sound = all the time. This is a second reason 
for using these symbols instead of common 
spelling: for some unusual words, it may be 
the easiest way to specify just how you want 
the word pronounced. 


TABLE 5-2 
PHONETIC SYMBOLS FOR SPEECH MODULE 


VOWELS, 


DIPHTHÓNCS CONSONANTS (Class 1) 


H 


X azure 


CONSONANTS (Class 2) 


Vo very 
(this 


zero 


d 
w 


* proncunced as one syllable 


FINE TUNING IN PHONETIC MODE 


There are several ways to change a sound's 
pitch, length, or loudness, as we saw in the 
previous examples, 


In phonetic mode, pitch can be set over a 
range of 9 steps, fram T (the lowest pitch) to 
9 (the highest pitch). The default volue is 
5, which is equivalent to the pitch you would 
hear with TALK-LEVEL, 


The pitch values 1-9 used with the phonetic 
speech mode cover a range of about half an 
octave, with the base pitch 5 in the middle, 


To change the pitch of a vowel or Class 2 
consonant in phonetic speech mode, put a 
mumber from 1 to 9 to the immediate left of 
ihe phonetic symbol, It is also a good idea 
to precede the pitch value with a space. zs in 
this exempl 


uos" ur 1 90" Œ 


Any spaces in phonetic speech mode have no 
effect an pronunciation, but the space before 
the pitch value resolves any ambiguity as to 
the meaning of the value, as will become clear 
shortly. 


Remember that TALK-LEVEL will disable any 
pitch variation, so you may need to give a 
TALK-WAVY command. ^ TALICFAST and 
TALK-SLOW will also have the expected 
effect, as will SET-PITCH and SET-VOLUME. 


Try these examples: 
PRON” 3 Sr 10" [E] 
row" n 5r 1. 10" i] 
TON" n se L 90" E) 
TEOR" 2 15 5L 10" E] 
You can also change the pitch contour of a 
word by inserting one of the following 
symbols (listed with their meanings) in front 
of a sound. 
ng 
falling 


= flat 


The contour symbol must be typed to the 
IMMEDIATE left of the phonetic symbol. For 
example, 


dediti 


represents a vowel sound falling in pitch, two 
steps at a time, then a rise in pitch during a 
long Le 


The pitch after one of these symbols will 
continue to rise, fall, or remain flat until 
either another pitch value (number or pitch 
contour symbol) or a Class 1 consonant [sec 
Table 5-2} is encountered. 


Try these examples: 
FEON" HXEEEXELLLLLO [R] 


Pou" IKEFEFPFTU" E) 


ROW" H<HRE 91110" [E] 


You can also change the stress on vowels, 
but not on consonants. Stress values affect 
the length and pitch of a vowel, A strongly 
stressed syllable should have a 3 after it. 
We heard what this does in the MY NAME I$ 
TOPO example earlier, in which the syllable 
IS was emphasized: 


UON" M 4t MGM 9<I3 «28,2 T 20 P 20") 


The value 2 means norma! stress, and 1 
after a vowel causes it to be REDUCED (to be 
much skorter.  lower-pitched, and less 
distinctive in quality]. You can get en even 
greater degree of reduction with a stress 
value of 8. 


A mumber between 0 and 3 right after a vowel 
is always taken to correspond to a stress 
setting. 


If the number is greater than 3, it is set 
equal to 3. 


It is recommended that you always put a 
space after a stress value, as in 


HOR" WES Lol ,5 wet 103" [i] 


This will eliminate any possible confusion 
between pitch values and siress values. 


You can gracually change the loudness of 
TOPO's speech in PHON" mode by using the 


symbol + to increase volume, and - to 
decrease |t. These symbols can occur 
anywhere and there can be more than one of 
them in a row, Try this example: 


TION" 1X0 E 0— X9 es REO eerxo" [E] 


We decrease the loudness of the second and 
third words three steps each (on the scale of 
0-15], then bring it up again. This shows, 
as you would expect, that + and - cancel 
each other out. and you have to use one of 
them to counteract the effect of the other to 
return to the original volume, 


As with pitch, this command makes an 
adjustment based on the latest SET-VOLUME 
value. 


The final notation that is perticular to 
phonetic mode is that used to insert a pause, 
or silence. 


With SAY", a pause of a particular length is 
inserted at a comma. The commo is also used 
in phonetic mode to indicate a pause, one to 
nine units long. (The "punctuation? comma 
of SAY" is equivalent to about five of these 
units). 


Each comma normally has a digit from 1 to 9 
after it, as in this example: 


PRON” HEI 81,4 WI,9 BUR] 


Again, it is a good idea to follow cach 
with a space, to avoid ambiguity. 


Any comma in phonetic mode without a follow- 
ing digit is interpreted as ,2 (not 41) 
Thus, à sequence of three commas in a row is 
equivalent to ,5. 


SPECIAL EFFECTS 


The commands presented at the beginning of 
this section will allow the user to chenge some 
of the basic characteristics of the way TOPO 
talks. For exemple, you can make TOPO talk 
in a bigh, fast voice (like a cartoon 
character)" using SET-PITCH ^ and 
TALK-FAST, 


To produce speech that is slower than 
normal, try inserting several more pauses. 
Some places in sentences respond to pauses 
better than others: anywhere you would put a 
punctuation mark; between subjects and 
Verbs, or verbs and direct objects: before 
many instances of 'which' or "hat: and so 
on. These are the places to try first - they 
mey sound awkward in some Sentences. fine 
in others. Experiment with a few sentences 
of your own. 


TOPO is also quite adept at reciting rhymes 
and poetry, and even singing [you can put 
the appropriate pitch on each vowel using 
SET-PITCH commands), but then the speech 
must be tailored to particular rhythms, 
Changes in rhythm require not only carefully 
timed pauses, but alteration of vowel length. 


Table 5-3 shows how to lengthen most of the 
vowels TOPO's speech module can produce. 
Those vowels not listed in the table do not 
sound very good when repeated to lengthen 
them. To lengthen a vowel even more, repeat 
the first character in the "long vowel column. 
To shorten a vowel, put a ‘I! after it, which 
indicates stress reduction. If you want to 
keep the pitch unchanged, put an appropriate 
pitch value in front of the vowel, too. 


TABLE 5-3 


HOW TO LENGTHEN VOWELS IN PHONETIC MODE 


SHORT VOWEL LONG VOWEL 
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Both vowel lengthening and extra pauses are 
used in the example below, the chorus nf the 
AndreAnthem, which can be sung to the tune 
of the Lumberjack's Song. 


I'm an Androbot, 
51 3M,5 AN AAS N DRO B;T,5 


and I'm OK 
AND, 13 M,5 03 ,5 EE ,7 


I charge all night 
1, C33 X1,4 91,3 8513 T,5 


and I work all day. 
AND |, WHR,4 41,3 D6 ,7 


FOREIGN LANGUAGES. 


You can make TOPO speak languages other 
than American English by using the PHON® 
commend, "(You can also use the SAY" 
command, but you will probably went to 
adjust the intonation using the methods 
available with PHON*.] TOPO will, of 
course, have a very American accent, since it 
can use only English sounds, strung together 
an English rhythm. TOPO's pronunciation 
of the foreign language will sound better or 
worse largely depending on how many foreign 
sounds are missing from its repertoire. 


For example, the consonant at the end of 
German 'ich' cannot be pronounced in the 
German way, and you will have to substitute 
a 'k, as do many American speakers of 
German, 


Here are some examples of TOPO's mul 
lingualism, as spoken with PHON': 


French: 
BON X 9«QR- 6 XQ M" PRL T 70 P 20/8] 

German: 
C6: TEN T 7&;K ,3 MIN N;3 ME ,3 IST , T 803 P 200] 
Spanish: 
961.2; ,5 M 76 9 SEM BR E , ES T TO P 20E] 
Italian: 

CK) 2 MM 563 , E 7Y; W 40 1 70 P 20[E] 
Chinese: 

We BF ,7 wt S8 291 , TO PO 
Japanese: 

H; J 841 MEO $T DE ,5 T B0 P 20 D 288 [E] 
Arabic: 


M BRR H; BN ,8 7A 5A 3 7IS , me ,2 T 90 P 20/8) 
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FOR PROGRAMMERS 


"Kloatu borada nikto!” (Gort, the robot, hod 
the power to destroy the earth - unless held 
in check by those mysterious words) 


-The Day the Earth Stood Stilt 
£1951, 20th Century Fox 


INTRODUCTION 


Section 1 of this manual includes a list of 
Suggested reading material to familiarize you 
with the FORTH programming language. We 
recommend that you learn FORTH before 
continuing with this section. If you use the 
book STARTING FORTH you will need to refer 
to our list of exceptions in the APPENDIX 
section of this manual. As you become more 
familiar with FORTH, you will become more 
aware of the many types of operations you can 
devise for TOPO, 


Many TOPO owners will enjoy controlling their 
robot even with little or mo previous program 
ming experience, We are certain, however, 
that many of you are programmers, or have 
computer experience and are interested 
making TOPO realize its full potential. 


This section is for you. 


ABOUT TOPOSOFT 


TopoSoft is a  FORTH-based application 
program. It adheres very closely to the 


n 


FORTH-79 Standard, and is written for ease of 
portability to other computer systems, 


You are encouraged to investigate the source 
code on the ToceSo!t diskette to better under- 
stand TopoSoft and to familiarize yourself with 
the techniques and style used in developing 
the program. 


The TopoSoft diskette storts with screens 
consisting of the boot image. Other screens 
include the MVP FORTH utilities source code, 
including the editor, assembler and other 
useful words, and the TopoSoft source code. 


Screen #139 is en index of all the screens on 
the TopoSo*t diskette. 


To study the source code, you should first 
copy the entire TopoSoft diskette and use the 
copy only. Save the original TopoSoft diskette 


in a safe place to avoid loss or damage. 


If you have a computer with only a single disk 
drive, use the existing DOS disk copy routine, 
er any other convenient disk copy program, 


To geickly copy the TopoSoft diskette with two 
disk drives, first boot your computer with 
TopoSoft. Then, ini z blank diskette 
with INIT-DISK, as described in Section 2. 


To copy the TopoSoft diskette onto the 
initialized diskette, insert the — TopoSoft 
disketie in disk drive W and insert the 
initialized diskette in disk drive 82. Then, 
type the command 


cory-prsx [a] 


After the messages 
uADS DRVL 


WuITES ON DEV2 


DO YOU MEAN IT (Y/N)? 
appear on the monitor, type 


Y 


and the computer will copy the TopoSoft 
diskette onto the initialized diskette. 


ADDITIONAL TOPO COMMANDS 


Earlier sections of this manual presented com- 
mancs for controlling TOPO's movement and 


speech. There are more commands, however, 
intended for those who wish to write more 
complex programs for TOPO. 


These commands, their purpose and examples 
of how to use them are presentad below. 


STATUS REQUEST COMMANDS 


The GET-POSITION command places on the 
stack the angle and distance TOPO has 
covered since the start of the currently 
executing motion command. If TOPO is not 
moving, the final positon from the last 
position command is returned. (The value Is 
cleared by RESET-MOTION, or at the start of 
= new motion). 


Here is an exemple using the GET-POSITION 
command: enter the command 


720 100 muove [E] 


and, while TOPO is moving, enter the 
commands. 


Ger-PosiTIO . .(R] 


This will get the current position and print 
the stack (top item first). If TOPO had just 
completed one turn, you would sce values of 
approximately 50 360, 


The GET-VELOCITY command places on the 
stack the current actual angular velocity (im 
degrees sec] and linear velocity (in cm/sec) of 
TOPO, For example, enter 


50 Srr-sPEED 300 RACK IR) 
While TOPO is still moving, enter 
creer . [E] 


This will get TOPO's current velocity and 
print the stack [top item first), The values 
should approximate -50 0 since TOPO is moving 
backward at 50 cm/sec with no angular 
velocity. 


The GET-HEADSWITCH command returns a 
single value on the stack. between 0 and 30. 
This five-bit number has one bit set or not set 
for each of the four headswitches. The least 
significant bit (bit 0) is not used end is 
always 0. Bit 1 corresponds to switch #1; bit 
2 to switch #2; bit 3 to switch #3 and bit 4 to 
switch #4, 


An "ON" bit means that that switch hes been 
pressed. For example, a value of 16 (10000) 
means that switch $i has been pressed. À 
value of 12 (01100) means that switches #2 and 
43 have been pressed, and a value of 0 
(00000) means that no switches have been 
pressed. 


TOPO's headewitches are latched, which means 
thet you can determine if a switch was pressed 
even if you do not perform a 
GET-HEADSWITCH command unti after the 
switch was released, A GET-HEADSWITCH 
also resets the latch, so all further requests 
will return O's until a switch has been released 
and is pressed e second time. 


M TOPO is still in HEADFOLLOW mode, you 
will probably want to DISABLE-HEADFOLLOW 
before — writin routines ^ using ^ the 
headswitches. Remember that TOPO will then 
stop automatically whenever you press any 
headswitch . 


For exemple, the following commands will read 
the heedswitches and make TOPO say "hello" 
whenever any switch Is pressed. TOPO will 
do this until switch #4 is pressed. 


: HELLO BEGIN GET-ZEADSWITOH DUP 
‘IF SAY" HELLO" THEN 
16 AMD UNTIL SAY" BYE BYE" 5 [E] 


The SPEECH-FULL? command returns a true on 
the stack if TOPO's on-board speech buffer ls 
fuli, Using FORTH conventions, 0 = false, 
and any other value = irue, This command is 
only needed if you are worried about 
overflowing the speech buffer. It holds 1700 
bytes, or more than one minute of normal 
speech, so an overflow should rarely, if ever, 


The TALKING? command returns a true on the 
stack if TOPO's speech beard is currently 
speaking. Note hat a significant pause 
between words can result in a temporarily false 
TALKING? condition. 


An example of how to use TALKING? is our 
implementation of TILL-SILENT, shown below: 


= TILL-SILENT BEGIN TALKING? NOT UNTIL ;[R] 


The TOPO-ON? command returns v true on the 
stack if TOPO js responding on the currently 
active channel [see MULTIPLE TOPO CONTROL 
in this section for an explanation of channels). 
TOPO-ON? returns a falso if no TOPO is 
responding on the current channel. 


Note that "public" channels [see MULTIPLE 
TOPO CONTROL) will always result in a false, 
since no responses are ever given to public 
channel messages. 


MORE CN MOTION CONTROL 


The GO-FOREVER command wil! couse TOPO to 
start moving at a given turn rate and linear 
velocity. and ie keep moving in that manner 
until another command is received. — GO- 
FOREVER expects en angular velocity (in 
degísec) and a linear velocity (In cm/sec] on 
the stack, with linear velocity on top {entered 
ost). 


CAUTION 


EXERCISE EXTREME CAUTION WHEN 
USING THE — GO-FOREVER COMMAND. 
TOPO WILL CONTINUE MOVING ON THE 
SAME PATH UNTIL ANOTHER COMMAND 
I$ RECEIVED, OR UNTIL TOPO PASSES 
OUT OF RANGE OF THE BASE COMMUNI- 
CATOR. 


GO-FOREVER is a "do forever" commend, 
which is sometimes useful if you know what 
you are doing. For example, to make TOPO 
Slowly turn right in place, enter 


50 0 co-vosz ves (E) 
To order a fast, tight circle, enter 
100 30 Go-FoREVER [E] 


To move slowly backward (forever, remember, 
50 be careful cut there), enter 


0 -5 co-Pornven [E] 


MULTIPLE TOPO CONTROL 


Most TOPO owners wili control only one TOPO 
at a time. TopoSoft, however, wili allow you 
to control up to 16 TOPOs independently. 


Every command sent from the — base 
Communicator contains a channel number, 
directing which TOPO or TOPOs should 
respond to the command. There are 16 
"private" channels [numbered 0-15), and four 
"public" channels (numbered PI-PU). First, 


we will discuss the private channels. 


TOPO is set at the factory with a default 
channel number assignment of channel #0. 
TopoSoft automatically sends commands over 
channel #0 unless instructed to do otherwise, 
so single-TOPO operations work correctly. 


Two commands allow you to change these 
Gefauit values. The command OPEN-CHANNEL 
instructs the base communicator to send all 
subsequent commands to TOPO over the new 
channel. For example, the command 


3 ormi-cuamean [E 
will cause all further TOPO commands (SAY", 


ARC, ete.) to be sent over channel 43, and 
the command 


ores-cuan.[F] 


cause all further commands to be sent over 
channel #0, the default condition after turning 
on the base communicator. 


After you change the base communicators 
channel! number with an OPEN-CHANNEL 
command, a TOPO on the old channel will bc 
unresponsive to commands. 


The command CHANCE-CHANNEL will instruct 
TOPO to respond t» commands on the new, 
private channel n 


For example, after you turn on both TOPO and 
your computer, the base communicator will 
send commands to TOPO over channel #0, and 
TOPO will respond to those commands, 


But. if you type the command 
3 CHANCK-CHANNEL E) 
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TOPO will respond to commands sent over 
channe! #3, and will not respond to commands 
from the base communicator until you change 
the base communicator's channel number tc 
correspond to TOPO's channel number, To de 
this, type the command 


3 orra-enum. [5] 


which will change the base communicator's 
channe! number to channel #3. 


(Note the order of CHANGE-CHANNEL and 
OPEN-CHANNEL, If you ordered an OPEN- 
CHANNEL first, TOPO would never receive the 
CHANGE-CHANNEL command). 


These commands sre useful when vou want to 
control two TOPOs independently. 


You cannot turn on more than one TOPO at 
tho same time, since both will be responding to 
the default channel #0, and the base 
communtcator will not be able to distinguish 
responses from a particular TOPO, 


To solve this problem, turn on the first TOPO 
and type the command 


1 CHANGE CHANNEL |È] 


This TOPO will now respond to commands only 
on channel #1, 


Then, turn on the second TOPO, It will be In 
the default condition, and will respond only to 
commands sent over chenne! $0, while the first 
TOPO will respond only to commands sent on 
channel #1, Now you can use OPEN-CHANNEL 
to talk to either TOPO. 


This technique can be extended for up to 16 
TOPOs. 


In addition to the 16 private channels, 
messages can be sent to TOPOs over four 
public channels, labeled Pt, P2, P3 and P4, 
To send a command over a public channel, use 
the OPEN-CHANNEL command zs with private 
Channels. For example, ihe command 


P1 OPEY-CHANNEL [E] 
will route ail further commands over channel 


PI unti changed to a private channel or a 
different public channel, 


Public channel Pl is en "all-call" channel. 
This means that all TOPOs within range will 
respond to commands sent over channel P1, 
regardless of their channel assignments. 


Channels Pz. P3 and P4 are programmable 
Public channels, which means that any 
designated TOPO can be programmed to 
respond - or not respond - to commands sent 
over these channels. 


The command 
a ERARLE-PUBLIC |i] 
directs the currently addressed TOPO(s) to 


respond to commands sent over public channel 
n (P2-Ph only), 


Similarly, the command 


wa DISABLE-PUBLIC E] 


directs the currently addressed TOPO(s) to 
ignore commands sent over the designated 
public channel. 


Ali TOPOs have a power-on default setting of 
P2-P4 dissbled [remember that Pl is always 
enebled and cannot be disabled). 


The following scenario demonstrates how you 
can control multiple TOPOs with these 
commands. 


Imagine a room with four active TOPOs, indivi- 
dually assigned to private channels 1, 2, 3 
and u. To make ali four TOPOs say "Hello i 
unison, type the commands 


PL OPEB-CHANMKL SAY" HELLO" [R] 


Te make only TOPOs 1 and 3 say "Hello" in 
unison, type the commands 


1 orxm-cnAxmuL P2 ERABLE-FUBLIC [E] 


3 OPEN-CHANHEL P2 EMABLE-PUBLIC [R] 


72 OFER-CHARWRL SAT" RELLO" [E) 


To reset public channel P2 for all four TOPOS, 
type the commana 


Fl OPEN-CHARNEL P) DTSARLE-POBLIC (E) 


At this point, some considerations on using 
public channels must be mentioned. 


Public channel P& may be automatically enabled 
or disabled for JOYSTICK or other system 
functions, so it should be used only with cau- 
tion. 


Since public channels are usually directing 
messages to more than one TOPO, any message 
requiring a response would probebly result in 
two or more TOPOs answering simultaneously, 


So both messages would be garbled. To avoid 
this garbling, TOPOs are programmed. to 
listen, but never to send any responses to 
public messages, This has two effects: 


1. Status requests from TOPO  (GET- 
POSITION, TILL-STOPPED, TALKING?, 
eic.) will have no effect when sent over 
Public channeis, since no answer will be 
sent, 


Public channel messages are not es 
reliable as those sent over private 
Channels, since the system nas no way te 
verify that the message was properly 
received by all TOPOs, 


If reliability is a concern, there are several 
alternatives to public channels for controlling 
multiple TOPOS, 


Consecutive motion commands to individual 
TOPOs will causo the robots to be ectivated 
nearly simultaneously. 


For speech commands, try sending 
SAY-LATER" commands to all individual 
TOPOs, then a SAY-IT command for, ta 
ensure reception, severa! SAY-IT commands] 
over the public channel. 


Appendix A 
TROUBLESHOOTING 


ERRORS DURING SYSTEM START-UP. 


PROBLEM EROBABLE SOLUTION 


Disk Drive 
not spinning Check electrical 


connections: 


Power off the computer and 
all externally attached de- 
Views (printer, etc.). 


Check tha wall outlet by 
plugging In a lamp. 


Is the disk drive connected 
properly? 


Is the TopoSoft diskette 
inserted in the disk drive 
(with the label facing up 
and toward the front of the 
disk drive)? 


stop spinning: 


sts the 
closed? 


disk drive door 


^ 


PROBLEM PROBABLE SOLUTION 


No visible 

display on 

monitor: 3. 1s monitor connected to the 
computer? 


Is monitor brightness con- 
trol adjusted properly? 


1s monitor power connected? 


Error message 
is displayed 
on monitor: 


“SERIAL CARD MOT FOUND IN SLOT #2" 


1. Turn off the computer and 
check for proper Super 
Serial Card installation. 


1f you are determined to 
leave the card where it is - 
in slot #5, for example, 
enter the command 


5 SETUP-SERTAL-SLOT [T] 


(use SAVE-FORTH to sove 
this new configuration]. 


PROBLEM PROBABLE SOLUTION 


Error Message 
is displayed 
on monito 


"INVALID BASE COMMUNICATOR RESPONSE" 


1. Is bese communicator red 
power indicator fight (in 
middle of center red panel) 
illuminated? IF not, is base 
communicator power supply 
(smaller black box) 
property connected? 


is base communicator cable 
properly connected at both 
ands? 


is serial card connector 
plugged into serial card? 


Are seriel card switches 
correctly configured? (See 
Section 2 for configuration 
instructions). 


Is serial card Jumper block 
properly installed? (See 
Section 2 for instructions) 


PROBLEM PROBABLE SOLUTION 


Error Message: 


‘TOPO NOT RESPONDING" 


. 1s TOPO turned on? 


1s battery status light on 
TOPO's back control panel 
GREEN? If light is RED, 
batteries need recharging. 


- Are there any obstructions 


TOPO's lights are 
off while battery 
is veing charged. 


between TOPO's headswitch 
and the base communicator? 


ls TOPO within range of 
the base communicator? 


Has TOPO been reconfig- 
ured by the previous user? 
Turn TOPO off, then on 
again. 


Is proper power supply 
(large black box) plugged 
in correctly? 


d TOPOSOFT COMMAND SUMMARY 


All TopoSoft commands are fisted below, 
followed immediately by thelr "stack effect 
(whether any numbers are consumed or 
generated by the command). Numbers before 
ihe -- are removed from the stack and used 
by the command. Numbers after the -- are 

a placed on the stack by the command. 
Commands with no effect on the stack are 

shown simply as ( 


DIRECT MOTION COMMANDS 


JOYSTICK (--) 
Initiates real-time joystick control. 


Terminated by pressing any key or 
button, 


FWD (distance 


Move forward "distance" (in centimeters). 


BACK (distance 


Move backward "distance" (in 
centimeters). 


LEFT (angle 


Turn left in piece "angie" [in degrees). 


rH 


RIGHT {angle --) 


Turn right in place "angle" (in degrees). 


ARC (angle, distance --} 


Move over a (generally) curved path of 
"distance" {in centimeters) forward while 
turning "angle" (in degrees} to the right. 
Negative values have the reverse effect. 


GO-FOREVER (turnrate, speed ==) 
Directly execute the given turn rate (in 
degreesísecond) and speed — (in 
centimeters/second) and maintain unti) 
another — direct motion command is 
received. Use only with caution. 

PARK (--) 


Stop TOPO and cancel the currently 
executing motion command(s) . 


MOTION PARAMETER CONTROL COMMANDS 


SET-SPEED (speed --) 


Set the target velocity (in centi 
meters/second) to be used with subse- 
quent motion commands, 


BL 


SET-RAMP acceleration 

Set the acceleration deceleration ramp (in 
centimeters/second?] to be used with 
Subsequent motion commands. 
MOVE-EXACT (--) 

Cause subsequent consecutive motion to 
come to a full stop between commands for 
more precise distance control. 
MOVE-SMOOTH 

Cause subsequent consecutive motion 
commands to blend together for smoother 
motion. This is the default setting. 
RESET-MOTION {--) 

Resets all motion parameters to their 
power-on values. Also causes TOPO to 


stop, and aborts any currently executing 
motion commands, 


MOTION STATUS-RELATED COMMANDS 


TILL-STOPPED ( 


Wait until all motion commands are 
completed before continuing command 
processing, 


GET-POSITION angle, distance! 


Get the elapsed angle and distance 
covered so far by the latest motion 
command. 


GET-VELOCITY i-- turnrate, speed) 


Get the current turn rate — [in 
degreesísecond) and speed {in 
centimeters/second] . 


HEADSWITCH COMMANDS 


GET-HEADSWITCH i-- bytel 


Returns a true for each  hezdswilch 
pressed since the last request, The 
return byte (D0-DT) uses bits D1-D4 for 
headswitches 1-1, The other bits are set 
to 0 (not used]. 


ENABLE-HEADFOLLOW ( 


Enable HEADFOLLOW mode using TOPO's 
headswitches. ^ This is the default 
setting. 


DISABLE-HEADFOLLOW (--) 


Disable any automatic motion using 
TOPO's headswitches. TOPO will now 
stop when any headswitch is pressed. 
Hezdswitches can still be read with 
GET-HEADSWITCH. 


Ba 


DIRECT SPEECH COMMANDS 


SAY" (1 


Speak the following text string until 
delimited by a closing quotation mark. 


PHON" (--) 
Speak the following phonetic codes until 


eelimited by a closing quotation mark, 


SAYH [number 


Speak the digits of the given number, 


DEFERRED SPEECH COMMANDS 


SAY-LATER^ (—) 


Load the following text into the speech 
module, but do not speak it yet. Speech 
will be activated by any speech command, 
except: TILL-SILENT, ' TALKING!; 
SPEÉCH-FULL?,  RESET-SPEECH or 
another SAY-LATER," 


SAY-T (--) 


A convenient command to activate 
SAY-LATER" speech. 


CONTROLS FOR PHONETIC t TEXT SPEECH 


SET-PITCH (number-! to 63 
Set the pitch (frequency) levet for 
subsequent speach, 1 is the lowest 


pitch; 63 is the highest pitch, 20 steps 
equal about one octave, 


SET-VOLUME [numberzü to 15 
Se: tha volume level for subsequent 


speech. 0 is the auletest level; 15 is the 
loudest level. 


TALK-FAST (==) 


Set the speech rate to "fast" for 
subsequent speech. 


TALK-SLOW ( 
Set the speech rate to "slow" (normat) for 


Subsequent speech. This Is the default 
setting. 


TALK-LEVEL (--] 
Disable all pitch variation for subsequent 


speech. 


TALK-WAVY (- 


Enable normai pitch variation — for 
Subsequent speech. This is the default 
setting 


RESET-SPEECH (--) 
Resets all speech parameters to their 


power-on values. Also interrupts any 
currently executing speech, 


CONTROLS FOR TEXT-TO-SPEECH ONLY 


SAY-LETTERS (—) 


Speak letter-by-letter for subsequent 

speech. 

SAY-WORDS (—) 

Speak words normally for subsequent 

Speech. This is the default setting 

SAY-SOME-PUNC ( 

Pronounce only the special symbols: 
eS IL. =e? 

for subsequent speech. This is the 

default setting 

SAY-MOST-PUNC ( 

Pronounce all printed punctuation symbols 


for subsequent speech. 


SAY-ALL-PUNC (—] 


Pronounce sll symbols received — - 
including spaces, carriage returns and 
linefeecis. 


SPEECH STATUS-RELATED COMMANDS 


SPEECH-FULL: flag) 

Returns a true (1) if the speech buffer is 
Tul. Returns a false (0) if the speech 
buffer is not full, 

TALKING? (+= flag} 

Returns a true (1) if the speech module 
is currently speaking. If not, returns a 
false (6). 

TILL-SILENT. € 


Wait until speech module is silent before 
continuing command processing. 


CHANNEL COMMANDS 


OPEN-CHANNEL (chennel 


Directs the base communicator te send all 
Subsequent commands over the new chan- 
nel. Valid channels are 0-15 (private) 
and PI-PL (public) 


CHANGE-CHANNEL (privatechannel - 


Directs TOPO to change its private 
channel assignment to the new channel. 
The new channel should be 0-15 (private) 
only, 


ENABLE-PUBLIC (publicchannel --} 


Directs TOPO to listen on the given 
public channel. No other public or 
private channels are affected. Valid for 
channels P2-PL only. 


DISABLE-PUBLIC (publicchannel --} 


irecis TOPO not to listen on the given 
public channel. No other public or 
private channels are affected. Valid for 
Channels P2-Pà only. The default setting 
is P2-P4 disabled. 


TOPO COMMANDS 


RESET-TOPO (--] 


Initiate a power-on sequence on TOPO. 
All on-board parameters will be reset to 
their default values, and any current 
execution will be cancelled 


TOPO-ON? (-- flag) 


Returns a irue (1) if TOPO is responding 
to commands. Returns a false (0) if rot. 
Wil only work properly if sent over & 
private channel. 


A 8502 machine language assembler for use 
with ^ TopoSoft is included in this 
implementation. Jt is, essentially, — the 
assembler written by William F. Ragsdale, 
published in FORTH DIMENSIONS, Volume 11, 
No. 5, and also published - with a glossary — 
in DR, DOBB'S JOURNAL, No. 59, Volume 5, 
issue $ (September, $981). Reprints of these 
Publications are avallable from Mountain View 
Press, whose address is printed in Section i 
of this manual. 


The following changes to the original should be 
noted. 


AGAIN, REPEAT, and WHILE, added to 


complement the existing BEGIN 
UNTIL. Their functions are similar to 
those of corresponding FORTH words. 


VS conditional for the overflow status bit 
added. 


‘TopoSoft end the utilities, as written, can be 
LOADed without the assembler being resident 
in memory. We have LOADed the assembler in 
at the end, so you can FORGET the assembler 
If you de mot need it and would like to free 
another 1300 bytes of memory. 


FORTH EDITOR COMMAND SUMMARY. 


The following is a brief summary of the editor 
commands which are not alrezdy standard FORTH 
words. The TopoScft editor {originally written 
by S.H. Daniel, and published in FORTH 
DIMENSIONS, Volume lil. No. 3) is the same as 
the editor printed in STARTING FORTH [see 
Section 1 of this manual), and we recommend that 
book as the best source for more detailed 
lexplangtions. 


EDITOR (--) 


Enabie the EDITOR vocabulary. All of ihe 
following commands (except where noted to be in 
khe FORTH vocabulery) will only be recognized 
when the EDITOR vocabulery is active. The 
Vocabulary is disabled whenever any colon 
definition is compiled. 


SCREEN OPERATIONS 


EDIT (screens —) 


List the given screen, and enable ihe 
EDITOR. Defined in the FORTH vocnbulery 
in TopoSoft. A handy word to avoid the 
frustration of forgetting to re-enable the 
EDITOR after a LOAD. Not shown in 
STARTING FORTH or MVP FORTH. 


bt 


WIPE ( 


Erase ihe current screen, Defined in the 
FORTH vocabulary. 


Le) 


Like the FORTH word LIST, except that the 
current screen number is obtained from the 
Verisbie SCR, rather than being typed in by 
the user. Not shown in STARTING FORTH. 


1 


(Next}. Increments the current screen 
number by one. This command is used just 
before tho L command, to allow the user to 
list the next sequential screen. Not shown 
in STARTING FORTH, 


(--) 


{Back},  Decrements the current screen 
number by one, This command is used 
before the L command, to allow listing of the 
previous sequential screen. Not shown in 
STARTING FORTH. 


LINE OPERATIONS. 


T inet --) 


(Type). Type the indicated line from the 
Current screen. Set the cursor to the start 
of the lino, 


P text (—) 


(Put, Any following text will be copied 
into the INSERT buffer. The INSERT buffer 
will be copled into the current line, 
replacing its previous contents. If the text 
consists of one or more blanks, the current 
line will be erased. 


U text C 


(Under). Any following text wili be copied 
into the INSERT buffer. Reads the screen 
at the line immediately below the current 
line, leaving a blank line. All following 
lines are pushed down, Any text on line 15 
will be lost, The contents of the INSERT 
buffer will be copied into the blank line, and 
that line will be made the current line. 


X (c 


(eXtract], Copies the current line into the 
INSERT buffer, and removes it from the 
screen. All following lines are moved up, 
and line 15 is left blank, 


M (blockt, linet 


iMove). Copies the current line into the 
INSERT buffer, then copies the INSERT 
buffer into the block, specified by block#, 
UNDER the lino specified by LINER, The 
original block number is restored. and the 
next line in the block becomes the current 
line. 


PP text (linet --) 


e P, but designates the line number Into 
which to put text. Defined in ALL ABOUT 
FORTH in the FORTH vocabulary, bul not 
shown in STARTING FORTH, 


EDITING OPERATIONS 


F text ( 


(Find). Any following text is copicd into 
the INSERT buffer. The contents of the 
INPUT buffer are comparad to the contents 
of the current screen, starting at the 
current line, If a maich is found, the lino 
is displayed with the cursor positioned 
immediately after the end of the string under 


search. Tf no match is found, the requested 
string is echoed to the terminal end the 
error message NONE is output. 


E C2 


(Erase). Erases backwards from the cursor, 
according te the number ef characters In the 
FIND buffer, This command should only be 
used Immediately after the F command, 


D text (=) 


(Delete), Any following text is copied into 
the FIND buffer, The D command is a com- 
bination of F and E commands. The string in 
the FIND buffer is matched against the con- 
tents of the current line and, if a match is 
found, the found string is deleted. 


Itext t 


Unsert). Any following text will be copied 
into the INSERT buffer, The | command 
copies the contents of the INSERT buffer 
into the current line, starting at the current 
Cursor position. Any text to the right of 
the cursor will be pushed to the right and 
will be pushed off the line and lost if the 
total length of the line exceeds 58 
characters. 


R text {--) 


(Replace). Any following text is copied into 
the INSERT buffer. The R command 
operates as a combination of the E (Erase) 
end | (insert) commands. Starting at the 
Current cursor position, and working 
backwards towards the start of tha line, text 
Corresponding to the length of ihe contents 
of the FIND buffer is deleted, and the 
contents of the INSERT buffer are inserted 
into the line. e the contents of the 
FIND buffer determine how much text will be 
erased, the R command should only be used 
immediately following the F (Find) command. 


TILL text (—) 


(THI. Any following text is copied inte the 
FIND buffer. Starting from the current 
cursor position, TILL searches the current 
line for a match with the contents of the 
FIND buffer. If a match is found, TILL 
deletes all the text on the line from the 
current cursor position up to and including 
the end of the matched text. 


S Text (lastscreen# +1) 


{Search}, Any following text is copied into 
the FIND buffer. Starting at the top of the 
Current screen and continuing until the 
bottom of the screen immediately before the 
screen number on the top of the stack, S 
scarchas for a match to the contents of the 
FIND buffer. Whenever a match is found, 
ihe line containing the match will be typed 
out, along with the line number and screen 
number in which the match occurred, 
Because of the way FORTH handles loops, 
‘the number on the top of the stack must be 
one higher than the highest screen to be 
searched, 


1 


Used as a terminator for all commands allow- 
ing text input, such as P, F, R, etc. Allows 
more thon oné command to be entered on a 
single line, as shown in the following ex- 
ample 


3 TP This ic line 3^ [E] 


Although useful, this feature does preclude 
the use cf the~as a character in any text to 
be put on the screen. 


ERROR MESSAGES 


The searched-for string was not found. 


NOT OM CURRENT EDITING SCREEN 


Invalid line number given. 


DRVI, DRV2, DRV3, DRVà, DRVS ( 


Equivalent to MVP FORTH words DRO 
through DR4, but more consistent with 
Apple computer disk drive numbering. 
Sets the screen offset so that any screen 
access 0 through 139 will use the specified 
disk drive, 


SAVE-FORTH ( 


SAVE-FORTH is now vectored through 
'SAVE-FORTH te call <SAVE-FORTH?. 


The following words referenced in ALL ABOUT 
FORTH are not implemented in MVP FORTH 
V1,0103.03 for the Apple computer. They 
consist, basically, of useless 8080 and CP/M 
Gisk-related functions: 


‘TESCALC, CTESCALC? , DISK-ERROR, 
DPUSH, DRIVE. HPUSH, NEXTI, RPP, 
SEC. SEC-READ, SEC-WRITE, SEG/DR, 
SET-DRIVE, SET-iO, SYSCALL, 
TàSCALC, TRACK. 


The following changes to MVP FORTH 
V1.0103.03 were made in creating TopoSoft: 


2/ function was replaced (it wes missing 
from MPV FORTH). 


COLD was rewritten with new TopoSoft 
boot message, Also, COLD was fixed to 
call ABORT, not CABORT>, 


DMIN utility was fixed to provide the 
correct polarity result. 


RP? in the assembler changed to RP] to 
conform to the original ^ assembler 
documentation, 


.S utility default was changed to print top 
of stack on the right. 


CALL utility was rewritten to facilitate 


loading without using the essembler. 


TITLE utility was rewritten with the 
TopoSoft message. 


The GRAPHICS vocabulary was deleted. 


Renssembled leaving only one hi-res 
graphics page {page 2). 


CREATE fixed to look for boundary at FF, 
not F. 


CORRECTIONS TO STARTING FORTH 


For use with TopoSoft/MVP FORTH for the 
Apple Ut and Apple lle computers. 


This list will enable a STARTING FORTH 
reader to learn FORTH using currently 
available MVP/TopoSoft FORTH Systems- 
STARTING FORTH is an excellent tutorial, 
but is written for a different dialect of 
FORTH (PolyFORTH) than we are using. 
This list was generated by working through 
STARTING FORTH on an Apple lle, but 
using a TopoSoft system end noting al 
differences that would trap the novice user. 


Note: Toposoft/MVP FORTH is based on the 
1979 FORTH Standard, the most 
widely accepted and documented 
version of FORTH available, 


Chapter 1 


Page 11 Examples given assume an &ü-column 
display. If you have a ü0-column 
display, some examples wil! wrap 
around to the next tine, 


We use 79-Standard, which allows 

up to 3! character names. Addi- 
tional characters ere allowed, but 
are ignored. 


Our "stack empty" error 
print the extraneous zero. 


Chapter 
Page 50 


Chapter 3 


Page 60 


2 


We have .S already implemented, so 
the given definition is not needed. 
it also won't work as defined ~ 
replace SO with SPO instead. Also, 
our .S will not print the extraneous 


?SWAP, 2DUP, 20VER, and 2DROP 

work, buf we prefer the words 
DSWAP, DDUP, DOVER, and DDROP 
to avoid confusion with the quantity 
2. Both sets are implemented, 


The word "screen" is often used 
interchangeably with the word 
"block. 


Apple lis end lle's have blocks 
0-139 on drive 1 and blocks 140-279 
on drive 2. 


Block 0 cannot be LOADed, so it is 
generally not used, 


Make it a habit to ALWAYS put a 
stack comment right after the name 
you are creating. 


This small amount cf extra typing 
will be well worth it, Also, be sure 
to put the space after the C. 


The single-letter editor commands 
(plus TILL) must be enabled by 
typing the word EDITOR first. 


EDITOR must also be re-typed efter any colon 
definition has been compiled. The word EDIT 
is a convenient way to avold this nuisance. !f 
met already on your system, it is - : EDIT { n 
—) LIST [COMPILE] EDITOR Use EDIT 
whenever you want to LIST a block, end it will 
automatically enable the EDITOR vocabulary as 
well, 


**Apple I+ users: use the right-arrow 
key for | and shift-M for ] 


Should be "Make it a habit to FLUSH 
before every COPY" 


s find all occurrences, mot just 
the first. 


DEPTH and .S already implemented. 
Example will not work as shown. 


Here are several additional useful word 
in MVP FORTH: 


THRU from, to Load blocks 
consecutively over the range from, to. 
Interrupt by pressing any key. 


INDEX (From, to Print the first 
line af every block ever ihe range 
from, to, Pause by pressing any key. 
Resume by pressing any key, or abort 
by pressing two keys in rapid 
succession, 


VUST (--} List the contents of the 
dictionary, starting with the most 
recent eniry. Pause by pressing any 
key. Resume by pressing any key, 


Chapter à 


Page 101 


102,103 


Chapter 5 


Page 119 


Chapter 6 


Chapter 7 


Page 164, 
182 


189.170, 
171,178 


or abort by pressing two keys in 
rapid succession. 


Our 78-Standard ABORT" marks 
the offending word with ^^^, but 
does not print it, 


Our 79-Standard !STACK does not 
return a flag, but automatically calls 
ABORT" if a stack error exists. 


in place of I, we prefer to use Ra 
instead. 1, "M, and J should be 
used only inside o^ DO loops. 


No corrections. 


, [ - : are not allowed as double- 
umber indicators. Only a single 
is allowed as a  double-number 
delimiter. The variable DPL saves 
the count of places after the decima! 
point. 


Our 79-Standard SIGN uses the top 
of the stack (and consumes i). 


173,179 
im 


178 


Chapter 8 


191 


193 


194 


208 


Chapter 9 


216,217 


216 


Replace SIGN with ROT SIGN in all 
examples given. 


D> is also included, 


We allow doublo-numbers inside 
definitions. 


Typo, second DUC should be: 
D. (d --) Prints the signed 32-bit 


Do not use SHUTTER as specified. 
it could cause your system to crash. 


We prefer DVARIABLE, D!, Dé, 
and DCONSTANT Instead. 


We allow double-numbers inside 
definitions, 


A better version of DUMP is already 
implemented, 


You MUST perform the word CFA 
before you EXECUTE a value 
returned by ' , thus 

" GREET CFA EXECUTE 


> is not Implemented in MVP 
FORTH. 


FS 


Standard usage saves the CFA, 
thus ' HELLO CFA ‘ALOHA ! and 
then, 'ALORA @ EXECUTE 


* behaves differently in a colon 
definition; see STARTING FORTH 
Appendix 3. |n these examples, 
replace ' in SAY with [COMPILE] * 
COMING and GOING will work as is, 
or replace [!] with © 


We use (NUMBER instead of 
{NUMBER}. 


EXECUTE expects a cfa (code field 
address or code pointer], not 2 pfa. 


In cur implementation, the 
non-standard STARTING FORTH 
variable SO is named SP0. Our 
79-5tandard word S0 is defined as 
SPo € 


236,240, 
247" A different variable TIB contains the 
starting address of the Input mes- 
sage buffer. 


Chapter 1¢ 


298.271, 
272,276" Replace SO with TIR 


276 An additional word BMOVE acts Just 
like CMOVE or <CMOVE but always 
works correctly even if the ranges 
involved overlap. 


zn 


277,178 
285 


Chapter 11 
301 
303 


306 


KEY works the same, but will not 
echo the character, 


WIPE already exists, but K won't 
work as is, Use: 


: K FIND-BUF PAD 80 MOVE 
INSERT-BUF FIND-BUF 80 MOVE 
PAD INSERT-BUF 80 MOVE ; 
The carríago-return key is received 
as a value 12. 


Our definition of NUMBER is 
different - it always returns a 
double-humber, and it — only 
recognizes a” leading - or an 
imbedded , but not :,- f 

in the PLUS example, insert DROP 
after NUMBER. 


For (DO) or 2>R, we use «DO» 


For (LITERAL), we use LIT 


In our implementation, it is OK to 
"it a carriage-return in the middle 
of o definition, 


We allow doublo-numbors inside 
definitions, 


Appendix G 
SHORTENING TOPOSOFT COMMANDS 


The TopoSoft commands presented in this 
menual were chosen using clarity, precision 
and consistency as the primary considerations. 
We realize, however, that having very short 
names sometimes “offers è number of 
advantages, especially where children or 
novice computer users ere involved, 


Fortunately, is very easy to create 
alternate, short-form names or abbreviations in 
FORTH, | For example, if vou prefer the short 
word JOY instead of JOYSTICK, simply create 


the colon defini 


Now, you can use either word. 


M you create new, short commands and do not 
want to re-enter them every time you use 
TOPO, be sure to save them with 
SAVE-FORTH. Better yet, save the source 
code with the editor so you can LOAD them 
easily, and se vou can look up o definition if 
you forget it. 


Three speech commands (SAY", PHON* and 
SAY-LATER*) are defined ^os FORTH 
"immediate" words, so renaming them is a bit 
trickier. For example, here is how to rename 
PHON" to PHONETIC": 


: PHONETIC" [COMPILE] PRON" ; IMMEDIATE [E] 


e 


If you rename TopoSoft commands, be sure to 
make your command names clear and easy to 
understand, TopoSoft commands usually start 
with verbs, because the TopoSoft commands da 
things. Nouns are appropriate for storage 
locations in memory, and this distinction will 
be more important when you start writing 
fency programs for TOPO. Also, you should 
be careful not to use names that are already 
used in TopoSoft, because you will mo longer 
be able to use the original words. 


When creating short, alternate names, there 
are severa! possible approaches. 


Many programmers, and several operating 
systems (such as UNIX], create abbrevietions 
by using the first letter of each sub-word. 
Thus  SET-PITCH — becomes SP, and 
TALK-WAVY becomes TW. This creates very 
short names which still preserve the functional 


form of the originai command. The obvious 
disecvantage is that the resulting names are 
often cryptic to anyone except land sometimes 
including] the original creator 


A second approach is to use short, real words 
which are suggestive of the original command 
or function, Exemples would be PITCH for 
SET-PITCH, or WAVY for TALK-WAYY. The 
advantage is that names will still make sense to 
anyone learning them. The disadvantage is a 
loss of clarity (whether PITCH, for example, 
means set the pitch, get the latest pitch, or Is 
just a variable named PITCH), 


Although short names are ^ sometimes 
convenient, we strongly encourage anyone 
actually writing programs to use the original 
longer names, ' This is important to keep your 
code understandable - to you ar anyone else. 


Appendix H 
SPECIFICATIONS 
The following are the electrical, mechanical 


and environmental specifications for TOPO and 
its base communicatoi 


PHYSICAL SPECIFICATIONS. 


Height: 36.5 Inches 
Width: 23 inches 
Depth. 17 inches 
Weight: 40 Ibs. 


Color: Ivory 


Materials: 


ABS plastic body; steel 
base 


Speed: 1 to 50 centimeters/second 


Turn rate: 


1 to 100 degrees/second 


Turning 
radius: 


Turns in its own width 


Drive system: Independent DC motors 


and gearboxes 


MAINTENANCE 


Battery charging iro a standard wall 
cute No — other maintenance 
required. Wash only with mild soap 
and water, 


Ht 


ELECTRICAL SPECIFICATIONS 


Electronics: 


Power: 


Batteries 


Battery time: 


Battery 
charger: 


Base 
communicator 
power: 


Maximum 
range: 


Software: 


On-board microprocessors 
communicate with the 
computer by way of 
infrared signals 


120 VAC for battery 
charger 


Two 5.5 Amp hour Get 
electrolyte, sealed re- 
chargeable. LED indicetes if 
batteries need recharging 
Three hours, depending on 


7h VAC; 20 VA 


12 VAC; 10 VA 


25 feet 


TopoSoft diskette for use 
with Apple !l* or lle 
included 


LPC-allophone-based 
text-to-speech system 


By keyboard command, 
program or joystick 


ENVIRONMENTAL SPECIFICATIONS 


Storage 

temperature 

range: -IPE to MICE 
U-2ÓC to 47°C) 


Operational 

temperature 

range: 50°F to 1049F 
[10°C to 4PC) 


TOPO will fee! comfortable 
where you feel comfortable. 
Do no: put TOPO near à 
stove or fireplace. and do 
not leave it in direct 
Sunlight. 


Humidity: Storage and operational 
ambient: 8% - 80% 
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